Lets an AI client manage contacts, networks, events, and digital business cards using plain language.
Also known as connectmachine/mcp-server, mcp-server
- Stars
- 9
- Tools
- 40
- Downloads, 30 days
- —
- Latest version
- 1.0.8
- Last commit
- Oct 23, 2026
- License
- MIT
What is ConnectMachine MCP?
ConnectMachine lets an AI client manage contacts, networks, events, and digital business cards using plain language. It exposes 40 tools, such as list_contacts, get_contact, search_contacts.
Summary generated from the project's README
About ConnectMachine MCP server
ConnectMachine allows users to manage their professional relationships and digital identities through an AI assistant. By connecting to a ConnectMachine account, you can use plain language to search, update, and organize contacts, networks, events, and digital business cards. The server is hosted and uses streamable HTTP, meaning there is no local installation required for the server itself.
Integration is straightforward with clients like Claude, ChatGPT, Cursor, VS Code, and GitHub Copilot. Authentication is handled via OAuth 2.1, which allows the client to open a sign-in page for your email or Google account without needing to manually paste tokens. For clients that do not support OAuth, a personal MCP key can be used as a static bearer token.
The server provides 40 specialized tools categorized into six areas: contacts, networks, events, digital cards, import/export, and profile management. These tools enable complex tasks such as merging duplicate contacts, importing CSV batches of up to 500 contacts, and managing digital business card details like social links and websites.
What you can do with it
- 1Organize networking contactsYou can ask your AI to group specific people into a labeled network or tag them based on a recent meetup.
- 2Clean up contact listsAn AI client can identify and resolve duplicate entries within your professional database.
- 3Manage digital business cardsYou can instruct an assistant to update your professional details on your digital cards.
- 4Bulk data migrationYou can use the server to bring large groups of contacts into your system from a CSV file.
Written from the project's README. Every use case is checked against a quote from it.
How to install ConnectMachine MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall ConnectMachine MCP in Claude Code
$ claude mcp add --transport http mcp-server https://mcp.connectmachine.ai/mcpInstall ConnectMachine MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.connectmachine.ai/mcp"
}
}
}Install ConnectMachine MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.connectmachine.ai/mcp"
}
}
}Install ConnectMachine MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp-server","type":"http","url":"https://mcp.connectmachine.ai/mcp"}'Install ConnectMachine MCP in Codex
$ codex mcp add mcp-server --url https://mcp.connectmachine.ai/mcpInstall ConnectMachine MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp-server] url = "https://mcp.connectmachine.ai/mcp"
Install ConnectMachine MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp-server https://mcp.connectmachine.ai/mcpInstall ConnectMachine MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.connectmachine.ai/mcp",
"type": "http"
}
}
}ConnectMachine MCP tools 40
Detected from the READMElist_contactsget_contactsearch_contactsfind_contactlist_industriesget_contact_countsget_duplicate_contactscreate_contactupdate_contactdelete_contactsmerge_contactsassign_contacts_to_network
| list_contacts | — | |
| get_contact | — | |
| search_contacts | — | |
| find_contact | — | |
| list_industries | — | |
| get_contact_counts | — | |
| get_duplicate_contacts | — | |
| create_contact | — | |
| update_contact | — | |
| delete_contacts | — | |
| merge_contacts | — | |
| assign_contacts_to_network | — |
Show all 40 toolsShow fewer tools
list_networkscreate_networkupdate_networkdelete_networkreorder_networkslist_eventsadd_events_to_contactremove_events_from_contactlist_cardsget_cardget_shared_cardread_card_imagecreate_cardupdate_carddelete_cardget_import_statuslist_import_sessionsexport_contacts_csvcreate_import_sessionimport_contacts_batchabort_importlist_notificationsget_unread_countget_profileget_subscription_statusget_enrichment_datamark_notification_readmark_all_notifications_read
| list_networks | — | |
| create_network | — | |
| update_network | — | |
| delete_network | — | |
| reorder_networks | — | |
| list_events | — | |
| add_events_to_contact | — | |
| remove_events_from_contact | — | |
| list_cards | — | |
| get_card | — | |
| get_shared_card | — | |
| read_card_image | — | |
| create_card | — | |
| update_card | — | |
| delete_card | — | |
| get_import_status | — | |
| list_import_sessions | — | |
| export_contacts_csv | — | |
| create_import_session | — | |
| import_contacts_batch | — | |
| abort_import | — | |
| list_notifications | — | |
| get_unread_count | — | |
| get_profile | — | |
| get_subscription_status | — | |
| get_enrichment_data | — | |
| mark_notification_read | — | |
| mark_all_notifications_read | — |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packageNot checked
- Remote endpoint uses HTTPSPass
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHubConnectMachine 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
Open ConnectMachine in the Claude directory and select Connect.
Or add it yourself under Settings → Connectors → Add custom connector with the endpoint above.
claude mcp add --transport http connectmachine https://mcp.connectmachine.ai/mcp
Then run /mcp in Claude Code and pick connectmachine to sign in.
Open ConnectMachine in ChatGPT and select Connect.
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"
}
}
}
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"
}
}
}
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 extensions install https://github.com/connectmachine/mcp-server
Then run /mcp auth connectmachine inside Gemini CLI to sign in.
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
ConnectMachine MCP questions
How do I add ConnectMachine MCP to Claude Code?
Run claude mcp add --transport http mcp-server https://mcp.connectmachine.ai/mcp in your terminal. Add --scope user to make it available in every project.
How do I add ConnectMachine MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does ConnectMachine MCP provide?
It exposes 40 tools, including list_contacts, get_contact, search_contacts, find_contact, list_industries.
What kind of tools are available?
The server provides 40 tools across six areas: Contacts, Networks, Events, Digital cards, Import and export, and Notifications and profile.