Model Context Protocol

Contalist MCP Server

Connect AI agents like Claude to your contacts. Let them search, create, and organize — on your behalf.

Contacts Tool

Manage contacts — one tool, ten actions

listPaginated list; filter by tag or group
searchSearch by name, email, organization, title, phone, note
getFetch one contact, incl. custom fields
createAdd a new contact (supports custom fields)
updateModify an existing contact
deleteArchive a contact (recoverable)
upsertCreate or update, matched by email
find_duplicatesSpot duplicate contacts by email, phone, or name
bulk_upsertImport many contacts in one call (max 500)
historyActivity timeline — notes, emails, calls, form submissions

Notes Tool

Interaction log on contacts

listList a contact's notes
addAdd a note (optional title and type)
updateEdit a note
deleteDelete a note

Relations Tool

Relationships between contacts

listList a contact's relationships
addLink two contacts (spouse, coworker, …)
removeRemove a relationship

Tags Tool

Free-form labels on contacts

listList all your tags
addTag a contact (by tag name)
removeRemove a tag from a contact
contactsList contacts with a tag

Groups Tool

Named collections of contacts

listList your groups
createCreate a new group
addAdd a contact to a group (by ID or name)
removeRemove a contact from a group
membersList group members

Templates Tool

Message templates with mail merge

listList your message templates
renderPreview a template merged for a contact

Organizations Tool

Companies and their contacts

listList your organizations; filter by name
getFetch one organization
createAdd a new organization
updateModify an organization
deleteDelete an organization
contactsList an organization's contacts

Guided Skills

Built-in prompts for common workflows

onboard_contactAdd a new contact with complete info
find_contactLocate and identify a person
update_contactApply changes to contact details
contact_cleanupFix duplicates and incomplete records
contact_summaryStats and insights about your network

Get connected

Option 1: OAuth recommended

Add the server to your MCP client

Point your client's MCP server URL at https://contalist.com/mcp — no credentials needed yet
Authorize in your browser

Your client opens the consent page — sign in and click Allow. Tokens are issued automatically and refreshed for you
Start asking

"Add John Doe from Acme to my contacts" — the agent handles the rest

Option 2: API key

Generate an API key

Log into Contalist → Account → API & Integration → Generate API key
Add the server with your key

Point your client at the endpoint below with the key as a Bearer token

Endpoint

POST https://contalist.com/mcp

Authorization: Bearer YOUR_API_KEY

Content-Type: application/json

Claude Desktop

  "mcpServers": {

    "contalist": {

      "url": "https://contalist.com/mcp",

      "headers": { "Authorization": "Bearer YOUR_API_KEY" }

curl

Two steps: initialize first, then pass the returned Mcp-Session-Id header on every call.

curl -i -X POST https://contalist.com/mcp \

  -H "Authorization: Bearer YOUR_API_KEY" \

  -H "Accept: application/json, text/event-stream" \

  -H "Content-Type: application/json" \

  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2026-07-28","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

# → response headers include: Mcp-Session-Id: abc123...

curl -X POST https://contalist.com/mcp \

  -H "Authorization: Bearer YOUR_API_KEY" \

  -H "Mcp-Session-Id: SESSION_ID_FROM_STEP_1" \

  -H "Content-Type: application/json" \

  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Contalist MCP Server · Protocol version 2026-07-28