ContactZapp

ContactZapp MCP server

Let an AI assistant find, read, add and update your contacts in ContactZapp.

ContactZapp keeps your contacts in sync across Google, Microsoft, Apple and CardDAV, and cleans up duplicates. This server gives an assistant the access your API key has.

ContactZapp hosts the server. There is nothing to install or run. This repository holds the registry entry (server.json), the logo and the setup steps. It does not hold the server's code.

What you need

• A ContactZapp account. The API key works on every plan, Free included.
• An API key. In ContactZapp, open Settings, then Advanced. Under API keys, choose Create key. Tick what the key can do, and copy it when it appears. It is shown once. Getting started walks through it.
• An assistant that can connect to a remote MCP server.

You sign in with the key only. There is no Connect button or sign-in window for the assistant yet.

Connect

Send the key as Authorization: Bearer cz_live_.... Replace cz_live_... with your key.

Claude Code

claude mcp add --transport http contactzapp https://app.contactz.app/api/v1/mcp \
  --header "Authorization: Bearer cz_live_..."

Cline (cline_mcp_settings.json)

{
  "mcpServers": {
    "contactzapp": {
      "type": "streamableHttp",
      "url": "https://app.contactz.app/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer cz_live_..."
      }
    }
  }
}

Cursor (mcp.json)

{
  "mcpServers": {
    "contactzapp": {
      "url": "https://app.contactz.app/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer cz_live_..."
      }
    }
  }
}

Other assistants ask for the same two things: the address and the header.

Open the address in a browser and you get an error. That is expected. An assistant sends its requests with POST.

Keep the key out of chats and tickets. If it leaks, revoke it in Settings, under Advanced, and make a new one.

Tools

Each tool calls the ContactZapp API with your key, so it has the permissions you gave the key. A key without the contacts:write scope cannot add a contact. No tool deletes a contact.

7 tools, as the server lists them. Generated by scripts/sync-tools.mjs.

Limits

You can make 60 requests a minute, all your keys together. Each tool call is one request. The limit is the same on every plan. Rate limits says what happens at the limit.

More

• MCP server guide
• API reference
• Privacy
• Help: support@contactz.app

Maintaining this repository

• The tool table is generated from the live server: run node scripts/sync-tools.mjs and commit README.md. A daily check fails while the table differs from what the server lists. The section heading stays ## Tools, which mcp.so reads to fill its listing.
• The registry entry is server.json, the only copy. Change it, raise its version, merge, then push the tag v<version>. The MCP Registry workflow checks the tag against the file and publishes it. A pull request that changes the file is validated first.