# ContactZapp

> ContactZapp is a freemium MCP server for productivity. MCP server for finding, reading and updating synced contacts with a ContactZapp key. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $7.99 a month
- **Platforms:** API, Web
- **Website:** https://contactz.app/developers
- **Repository:** https://github.com/contactzapp-public/contactzapp-mcp
- **MCP Registry name:** app.contactz/contactzapp
- **Categories:** productivity, communication
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://app.contactz.app/api/v1/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "contactzapp": {
      "url": "https://app.contactz.app/api/v1/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/contactzapp
