# ContactZapp

This MCP server for Claude Code gives an assistant access to ContactZapp contacts. It can find, read, add, and edit entries, then start a sync.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: contactzapp-public
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/contactzapp-public/contactzapp-mcp
- Updated: 2026-11-11
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/contactzapp

## What it does

The server connects an assistant to ContactZapp contact actions. It can search by email, phone number, or text, read a record, create one, and edit it. It can also start a sync and list events. Contact deletion is not supported.

Setup requires a ContactZapp account, an API key, and an assistant that connects to remote MCP servers. The key goes in the `Authorization` header, and its scopes control access. A key without `contacts:write` cannot create contacts. All keys share a limit of 60 requests per minute.

## Requirements
- Remote server: `https://app.contactz.app/api/v1/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http contactzapp https://app.contactz.app/api/v1/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add contactzapp --url https://app.contactz.app/api/v1/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "contactzapp": {
            "url": "https://app.contactz.app/api/v1/mcp"
        }
    }
}
```

### GitHub Copilot

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

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http contactzapp https://app.contactz.app/api/v1/mcp
```

## When to use it
- find a contact by email address or phone number
- read a selected contact record
- create a contact with the `contacts:write` scope
- edit a record or start a sync

## Example prompts
- Find the contact with the email `alex@example.com`.
- Add a contact named Alex with the email `alex@example.com`.
- Start a contact sync.

## Similar
- [centric-demo](https://affpapa.org/en/nevibecode/mcp/centric-demo.md) — MCP server · 307 installs
- [gmail-skill](https://affpapa.org/en/nevibecode/skills/gmail-skill.md) — skill · 3600 installs
- [contacts](https://affpapa.org/en/nevibecode/skills/contacts.md) — skill · 3300 installs
- [use-spark](https://affpapa.org/en/nevibecode/skills/use-spark.md) — skill · 539 installs
- [spark-persona-exec-assistant](https://affpapa.org/en/nevibecode/skills/spark-persona-exec-assistant.md) — skill · 364 installs
- [zoho-mail](https://affpapa.org/en/nevibecode/skills/zoho-mail.md) — skill · 181 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
