# CardDAV address books

> CardDAV address books is an open-source MCP server for productivity. Read and write CardDAV contacts, groups and photos from an MCP client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Website:** https://carddav-mcp.ni-c.de
- **Repository:** https://github.com/ni-c/carddav-mcp
- **MCP Registry name:** io.github.ni-c/carddav-mcp
- **Categories:** productivity
- **Listing updated:** 2026-11-15

## About

Instead of a vendor API, this server talks straight to your own CardDAV server, the standard behind Nextcloud, Radicale, Baikal, SOGo, Fastmail, mailbox.org and iCloud. You paste a server root or a single address book URL and it finds the books behind it, reporting which vCard versions each one accepts. Google Contacts is not supported because it needs OAuth.

It registers up to seventeen tools, or a curated set of six with CARDDAV_ALLOW_TOOLS=essential, which the README argues helps a model pick the right one. Listings ask the server for a dozen named properties rather than whole cards, so inline photos do not bloat results, and entries are flagged as partial. Writes are applied to the card as stored and carry its ETag, so unmodelled properties survive and a concurrent change is reported rather than overwritten.

Safety is a focus. Destructive tools ask a person through MCP elicitation, or through a server-issued token where the client has no dialog. Contact text is fenced and checked for prompt-injection patterns, and CARDDAV_READ_ONLY=true leaves the write tools unregistered.

## Features

- **Both group conventions:** Reads vCard 4 KIND:group and Apple's X-ADDRESSBOOKSERVER-KIND groups, and writes whichever the book already uses.
- **Read-only mode:** CARDDAV_READ_ONLY=true registers only the read tools.
- **Tool allow and deny lists:** CARDDAV_ALLOW_TOOLS and CARDDAV_DENY_TOOLS trim the tool set, including a curated essential preset.
- **Safe writes:** Changes apply to the stored card with its ETag, so unknown properties are kept and conflicts are reported.
- **Confirmation for deletes:** Destructive tools ask a person via MCP elicitation or a target-bound token.
- **Partial birthdays:** A birthday without a year is reported as month and day instead of being dropped or given an invented year.

## Good for

- Look up a colleague's full contact card from an AI assistant
- Add or correct contacts in a self-hosted Nextcloud or Radicale
- Manage contact groups without breaking how Apple Contacts shows them
- Fetch a contact photo
- Give an assistant read-only access to an address book

## Install

### Claude Code (Terminal)

```sh
claude mcp add carddav-mcp --env CARDDAV_URL='<CARDDAV_URL>' --env CARDDAV_PASSWORD='<CARDDAV_PASSWORD>' --env CARDDAV_TOKEN='<CARDDAV_TOKEN>' -- npx -y @ni-c/carddav-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/carddav-mcp"
      ],
      "env": {
        "CARDDAV_URL": "<CARDDAV_URL>",
        "CARDDAV_PASSWORD": "<CARDDAV_PASSWORD>",
        "CARDDAV_TOKEN": "<CARDDAV_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/carddav-mcp"
      ],
      "env": {
        "CARDDAV_URL": "<CARDDAV_URL>",
        "CARDDAV_PASSWORD": "<CARDDAV_PASSWORD>",
        "CARDDAV_TOKEN": "<CARDDAV_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "carddav-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/carddav-mcp"
      ],
      "env": {
        "CARDDAV_URL": "<CARDDAV_URL>",
        "CARDDAV_PASSWORD": "<CARDDAV_PASSWORD>",
        "CARDDAV_TOKEN": "<CARDDAV_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/carddav-mcp"
      ],
      "env": {
        "CARDDAV_URL": "<CARDDAV_URL>",
        "CARDDAV_PASSWORD": "<CARDDAV_PASSWORD>",
        "CARDDAV_TOKEN": "<CARDDAV_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/carddav-mcp"
      ],
      "env": {
        "CARDDAV_URL": "<CARDDAV_URL>",
        "CARDDAV_PASSWORD": "<CARDDAV_PASSWORD>",
        "CARDDAV_TOKEN": "<CARDDAV_TOKEN>"
      }
    }
  }
}
```

## Tools

- `list_contacts`: Lists contacts using a small set of named properties and marks entries as partial

## FAQ

### Which address book servers work?

Any CardDAV server; the README names Nextcloud, Radicale, Baikal, SOGo, Fastmail, mailbox.org and iCloud, and says it is tested against Radicale and Baikal in CI. Google Contacts is not supported.

### What do I need to run it?

Node.js 24 or newer, or Docker, plus a CardDAV server and an account. Most hosted services want an app-specific password.

### Can I stop it from changing contacts?

Yes. Set CARDDAV_READ_ONLY=true and only the read tools are registered.

### Can I use it in a client that cannot launch local processes?

The site points to mcp-hub, a bridge that serves stdio MCP servers over Streamable HTTP behind an OAuth 2.1 login.

### Is CardDAV address books free?

Yes. CardDAV address books is open source, so you can use and self-host it for free.

### How do I add CardDAV address books to Claude Code?

Run this command in your terminal: claude mcp add carddav-mcp --env CARDDAV_URL='<CARDDAV_URL>' --env CARDDAV_PASSWORD='<CARDDAV_PASSWORD>' --env CARDDAV_TOKEN='<CARDDAV_TOKEN>' -- npx -y @ni-c/carddav-mcp

### What are the best alternatives to CardDAV address books?

The closest alternatives to CardDAV address books are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## 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.
- [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.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/carddav-address-books
