Skip to content
MCP server

ContactZapp

MCP server for finding, reading and updating synced contacts with a ContactZapp key

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.0.6
Listing updated
3 days ago

About ContactZapp

ContactZapp is a freemium MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.

ContactZapp keeps address books synced both ways across Google, Microsoft, Apple and CardDAV and merges duplicates. This server hands an assistant a small set of contact tools backed by the account's API key, where each key can be limited to reading, writing, or both.

The tools are contact_find (by email, phone number or text), contact_read, contact_create, contact_change, sync_start (the same as Sync now) and event_list. Read tools need the contacts:read scope, writes need contacts:write, and sync_start needs sync:trigger. The limit is 60 requests a minute across all keys, on every plan.

The endpoint is hosted at app.contactz.app/api/v1/mcp. You can sign in or use a key, and the same API also feeds n8n, Make and Zapier.

Install

Run in a terminal

claude mcp add --transport http contactzapp https://app.contactz.app/api/v1/mcp

Add to Settings → Connectors → Add custom connector

https://app.contactz.app/api/v1/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "contactzapp": {
      "url": "https://app.contactz.app/api/v1/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "contactzapp": {
      "type": "http",
      "url": "https://app.contactz.app/api/v1/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "contactzapp": {
      "serverUrl": "https://app.contactz.app/api/v1/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "contactzapp": {
      "type": "http",
      "url": "https://app.contactz.app/api/v1/mcp"
    }
  }
}

Tools this server provides (7)

Read directly from the server.

api_key_check
Returns the user the request acts for, the user's plan, the user's sign-in email and the scopes of the API key or connected app that made it. Any live key or access token can call it, so call it to test one.
contact_find
Finds the user's contacts by email address, phone number or text. Give at most one of `email`, `phone` and `query`: - `email` finds the contacts with that address. Case does not matter. - `phone` finds the contacts with that number, however it is formatted. - `query` searches the way the Contacts screen's search does. - With none of them, every contact is listed, newest first. Deleted and merged c
contact_create
Adds a contact. If the user already has this person, the values may go to that contact instead: - If the user's Auto-Merge level covers the match, the values are added to the existing contact: 200, `merged`. - Otherwise a new contact is created: 201, `created`. If it may be a duplicate, it also waits in Review duplicates: 201, `needs_review`. ContactZapp saves the contact in one two-way account: t
contact_read
Returns one contact. `id` is the contact's `id` or its `publicId`, such as `CS-0042`. A deleted or merged contact is a 404, and so is another user's contact.
contact_change
Changes a contact, as editing it in ContactZapp does. Only the fields you send change. A field you leave out keeps its value. The change goes to every two-way account the contact is in, never to a read-only one. History records it as the user's change and names the API key or the connected app that made it. A contact waiting in Review duplicates cannot be changed until the review is decided: 409,
sync_start
Starts a sync, the same as Sync now in ContactZapp. History shows it as a manual run. The answer is 202 with the sync's state, `queued` or `running`. If a sync is already going, you get that one back and no second one starts.
event_list
Lists the events of one type, newest first. Zapier, Make and n8n poll this to start an automation. Each item's `id` never changes. Poll again and the items you already have come back with the same ids, with new ones on top. Skip the ids you have seen. - `contact.created`, `contact.updated`, `contacts.merged` and `account.needs_attention` come from History, and are kept as long as History keeps the

What it does

Contact search
Finds contacts by email, phone number or free text.
Create and change
Adds contacts or edits them as ContactZapp does.
Scoped keys
Keys grant read, write, or both.
Manual sync
sync_start triggers a sync like Sync now.
Event feed
event_list shows events of one type, newest first.

Good for

  • Look up a person's phone number from a chat
  • Add a contact from a meeting note
  • Trigger a sync after bulk changes
  • Review recently created contacts

Pricing

Freemium, from $7.99 a month

Free for 2 accounts and 100 contacts; Easy listed at $7.99/month, Unlimited at $15.99 (annual sale prices shown)

Prices change. Check contactz.app before you buy.

ContactZapp FAQ

What limits apply?

60 requests per minute across all your keys, the same on every plan.

Can a key be read-only?

Yes. A key can read, write or both.

Which address books sync?

Google, Microsoft, Apple and CardDAV.

Is ContactZapp free?

ContactZapp has a free plan, with paid plans for more usage or features. Paid plans start at $7.99 a month.

How do I add ContactZapp to Claude Code?

Run this command in your terminal: claude mcp add --transport http contactzapp https://app.contactz.app/api/v1/mcp

What are the best alternatives to ContactZapp?

The closest alternatives to ContactZapp are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

Alternatives to ContactZapp

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media