About ConnectMachine
ConnectMachine is an MCP server for managing contacts, networks, events, and digital business cards through AI assistants. Its hosted endpoint provides tools spanning six areas of account data.
Key features
- 01Search, create, and update contacts
- 02Identify and merge duplicate contacts
- 03Organize contacts into networks
- 04Record events linked to contacts
- 05Create and edit digital cards
- 06Bulk import and CSV export
Use cases
- 01Find contacts met at a particular event
- 02Import a CSV into an investor network
- 03Tag conference contacts with an event
- 04Update a card’s title and social links
MCP support
It provides a hosted MCP server over Streamable HTTP, with OAuth 2.1 or personal-key authentication. MCP clients can use tools for contacts, networks, events, cards, and data import and export.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.connectmachine.ai/mcpclaude mcp add --transport http ai-connectmachine-connectmachine https://mcp.connectmachine.ai/mcp{"mcpServers":{"ai-connectmachine-connectmachine":{"type":"http","url":"https://mcp.connectmachine.ai/mcp"}}}Open in Cursor{"servers":{"ai-connectmachine-connectmachine":{"type":"http","url":"https://mcp.connectmachine.ai/mcp"}}}Open in VS Code{"mcpServers":{"ai-connectmachine-connectmachine":{"type":"http","url":"https://mcp.connectmachine.ai/mcp"}}}{"mcpServers":{"ai-connectmachine-connectmachine":{"serverUrl":"https://mcp.connectmachine.ai/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project README
ConnectMachine MCP Server
Your contacts and digital business cards, inside any AI assistant.
Search, update and organize your ConnectMachine contacts, networks, events and cards in plain language from Claude, ChatGPT, Cursor, VS Code and any MCP client.
What you can ask
"Who did I meet at the Bangalore meetup last week that works in fintech?"
"Find duplicates in my contacts and merge the obvious ones."
"Import this CSV into a new network called Investors."
"Tag everyone from today's conference with the event and draft a short follow-up for each."
"Update my business card with my new title and LinkedIn."
Connect
The server is hosted. There is nothing to install or run yourself, and this repository holds only the registry manifest and documentation.
| Endpoint | https://mcp.connectmachine.ai/mcp |
| Transport | Streamable HTTP |
| Auth | OAuth 2.1 with Dynamic Client Registration and PKCE |
| Account | Any ConnectMachine account |
Your client discovers the OAuth settings on its own, so you never paste a token. The first time a tool runs, it opens the ConnectMachine sign-in page. Sign in with your email (one-time code) or Google, approve, and the tools are ready.
Set up your client
Claude (claude.ai, desktop and mobile)
Open ConnectMachine in the Claude directory and select Connect.
Or add it yourself under Settings → Connectors → Add custom connector with the endpoint above.
Claude Code
claude mcp add --transport http connectmachine https://mcp.connectmachine.ai/mcp
Then run /mcp in Claude Code and pick connectmachine to sign in.
Cursor
Use the Install in Cursor button above, install the ConnectMachine plugin, or add this to ~/.cursor/mcp.json:
{
"mcpServers": {
"connectmachine": {
"url": "https://mcp.connectmachine.ai/mcp"
}
}
}
VS Code and GitHub Copilot
Use the Install in VS Code button above, or add this to .vscode/mcp.json:
{
"servers": {
"connectmachine": {
"type": "http",
"url": "https://mcp.connectmachine.ai/mcp"
}
}
}
Cline
Add this to cline_mcp_settings.json (MCP Servers → Configure → Configure MCP Servers):
{
"mcpServers": {
"connectmachine": {
"type": "streamableHttp",
"url": "https://mcp.connectmachine.ai/mcp"
}
}
}
Important
Set
typetostreamableHttpexactly. Without it Cline falls back to SSE and the server answers405. See llms-install.md for steps an agent can follow.
Gemini CLI
gemini extensions install https://github.com/connectmachine/mcp-server
Then run /mcp auth connectmachine inside Gemini CLI to sign in.
Any other client (static key instead of OAuth)
If your client can't run the OAuth flow, sign in at https://licenses.connectmachine.ai/mcp/auth to get a personal MCP key. Send it as an Authorization: Bearer <key> header on the server entry. Keys don't expire.
Tools
40 tools across six areas. Everything is scoped to your own account, and the server never reaches outside ConnectMachine, so every tool is annotated openWorldHint: false.
| Area | Tools | What it covers |
|---|---|---|
| Contacts | 12 | Search, create, update, merge and de-duplicate contacts |
| Networks | 5 | Group contacts into labelled networks |
| Events | 3 | Record where you met people |
| Digital cards | 7 | Create and edit your business cards |
| Import and export | 6 | Bulk import and CSV export |
| Notifications and profile | 7 | Notifications, profile and plan |
Note
⚠ marks tools annotated
destructiveHint: true. They overwrite or remove data this server can't restore, so clients should confirm before calling them.
Contacts
| Tool | Kind | What it does |
|---|---|---|
list_contacts | read | List contacts with pagination and filters |
get_contact | read | Full details for one contact |
search_contacts | read | Search across name, company, title, email, phone, notes, location, events |
find_contact | read | Resolve a name to one contact, or report an ambiguity |
list_industries | read | The industry catalog used for filtering |
get_contact_counts | read | Contact counts broken down by source |
get_duplicate_contacts | read | Surface suspected duplicates without merging |
create_contact | write | Create a contact, optionally tagged with events |
update_contact | write ⚠ | Overwrite fields on an existing contact |
delete_contacts | write ⚠ | Permanently remove contacts |
merge_contacts | write ⚠ | Merge duplicates; the secondary record is removed |
assign_contacts_to_network | write ⚠ | Move contacts into a network |
When two contacts share a name, find_contact reports the ambiguity and the assistant asks which one you mean instead of guessing.
Networks
| Tool | Kind | What it does |
|---|---|---|
list_networks | read | List your networks (labels) |
create_network | write | Create a network |
update_network | write ⚠ | Rename or restyle a network |
delete_network | write ⚠ | Remove a network |
reorder_networks | write ⚠ | Change network ordering |
Events
| Tool | Kind | What it does |
|---|---|---|
list_events | read | Conferences and meetups where you met contacts |
add_events_to_contact | write | Tag a contact with where you met them |
remove_events_from_contact | write ⚠ | Detach events from a contact |
Digital cards
| Tool | Kind | What it does |
|---|---|---|
list_cards | read | List your business cards |
get_card | read | Full details for one card |
get_shared_card | read | Resolve a public share link to card data |
read_card_image | read | Read a card's image asset |
create_card | write | Create a card with emails, phones, websites, socials |
update_card | write ⚠ | Overwrite fields on a card |
delete_card | write ⚠ | Remove a card |
Import and export
| Tool | Kind | What it does |
|---|---|---|
get_import_status | read | Progress of an import session |
list_import_sessions | read | All import sessions |
export_contacts_csv | read | Export contacts to CSV (Premium) |
create_import_session | write | Start an import batch |
import_contacts_batch | write | Import up to 500 contacts per call |
abort_import | write ⚠ | Cancel an in-progress import |
Notifications and profile
| Tool | Kind | What it does |
|---|---|---|
list_notifications | read | List notifications |
get_unread_count | read | Unread notification count |
get_profile | read | Your ConnectMachine profile |
get_subscription_status | read | Plan and subscription status |
get_enrichment_data | read | Profile completion suggestions |
mark_notification_read | write ⚠ | Mark one notification read |
mark_all_notifications_read | write ⚠ | Mark every notification read |
Registry
server.json is the manifest published to the official MCP Registry under the DNS-verified ai.connectmachine namespace. The registry feeds downstream catalogs, including the GitHub MCP Registry. gemini-extension.json lists the server in the Gemini CLI extension gallery.
Docs and support
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.