# Carddav MCP

> Carddav MCP is an open-source MCP server for communication. MCP server giving AI assistants read and write access to CardDAV address books. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Self-hosted
- **Repository:** https://github.com/langmail/carddav-mcp
- **MCP Registry name:** io.github.langmail/carddav-mcp
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-19

## About

The README describes carddav-mcp as a Model Context Protocol server that lets an assistant reach contacts stored on a CardDAV server. Once connected, a client can enumerate address books, list the contacts inside one, pull the full record for a single contact, and create, edit or delete entries.

The server runs over stdio and is launched with npx. It needs a base URL, username and password for the CardDAV server, supplied as environment variables. Updates are partial: fields that are not passed stay as they are, and vCard properties written by other clients are kept intact.

It suits developers and power users who want an AI client to work with an existing CardDAV contacts store rather than a hosted address book. The README also mentions a separate hosted product from the same team for mail, calendar and contacts, but this package itself is a local server.

## Features

- **Address book listing:** Lists the available address books on the CardDAV server with their names and URLs.
- **Contact search and retrieval:** Lists contacts in an address book and fetches the full record of one contact, including the raw vCard.
- **Contact creation:** Creates a new vCard contact with a display name, structured name parts, emails, phones, organisation, title and note.
- **Partial contact updates:** Changes only the fields provided and preserves vCard properties written by other clients.
- **Contact deletion:** Removes a contact from an address book by its UID.

## Good for

- Letting an AI assistant look up a phone number or email in an existing CardDAV contacts store
- Adding new contacts from a conversation or pasted text into a self-hosted address book
- Bulk-tidying contact details such as job titles or emails through an AI client
- Keeping contacts in sync with other CardDAV clients without overwriting their fields

## Install

### Claude Code (Terminal)

```sh
claude mcp add carddav-mcp --env CARDDAV_BASE_URL='<CARDDAV_BASE_URL>' --env CARDDAV_USERNAME='<CARDDAV_USERNAME>' --env CARDDAV_PASSWORD='<CARDDAV_PASSWORD>' -- npx -y carddav-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "carddav-mcp"
      ],
      "env": {
        "CARDDAV_BASE_URL": "<CARDDAV_BASE_URL>",
        "CARDDAV_USERNAME": "<CARDDAV_USERNAME>",
        "CARDDAV_PASSWORD": "<CARDDAV_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "carddav-mcp"
      ],
      "env": {
        "CARDDAV_BASE_URL": "<CARDDAV_BASE_URL>",
        "CARDDAV_USERNAME": "<CARDDAV_USERNAME>",
        "CARDDAV_PASSWORD": "<CARDDAV_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "carddav-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "carddav-mcp"
      ],
      "env": {
        "CARDDAV_BASE_URL": "<CARDDAV_BASE_URL>",
        "CARDDAV_USERNAME": "<CARDDAV_USERNAME>",
        "CARDDAV_PASSWORD": "<CARDDAV_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "carddav-mcp"
      ],
      "env": {
        "CARDDAV_BASE_URL": "<CARDDAV_BASE_URL>",
        "CARDDAV_USERNAME": "<CARDDAV_USERNAME>",
        "CARDDAV_PASSWORD": "<CARDDAV_PASSWORD>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "carddav-mcp"
      ],
      "env": {
        "CARDDAV_BASE_URL": "<CARDDAV_BASE_URL>",
        "CARDDAV_USERNAME": "<CARDDAV_USERNAME>",
        "CARDDAV_PASSWORD": "<CARDDAV_PASSWORD>"
      }
    }
  }
}
```

## Tools

- `list-address-books`: List all address books returning both name and URL
- `list-contacts`: List all contacts in the address book specified by its URL. Returns a summary per contact; use get-contact for full details.
- `get-contact`: Get the full details of a single contact in the address book specified by its URL
- `create-contact`: Creates a contact (vCard) in the address book specified by its URL.
- `update-contact`: Updates an existing contact in the address book specified by its URL. Only provided fields are changed.
- `delete-contact`: Deletes a contact in the address book specified by its URL

## FAQ

### What credentials does the server need?

It requires CARDDAV_BASE_URL, CARDDAV_USERNAME and CARDDAV_PASSWORD environment variables. The password is marked as secret in the registry entry.

### How do updates handle fields written by other apps?

The README says partial updates preserve vCard properties written by other clients, and only the fields you provide are changed.

### How is Carddav MCP started?

The README's setup config runs it with npx carddav-mcp over stdio, with the three CardDAV environment variables set in the client configuration.

### Does Carddav MCP need a hosted service?

No. The server runs locally against your CardDAV server. The README separately mentions a hosted product from the maintainers, which is not required to use this package.

### Is Carddav MCP free?

Yes. Carddav MCP is open source, so you can use and self-host it for free.

### How do I add Carddav MCP to Claude Code?

Run this command in your terminal: claude mcp add carddav-mcp --env CARDDAV_BASE_URL='<CARDDAV_BASE_URL>' --env CARDDAV_USERNAME='<CARDDAV_USERNAME>' --env CARDDAV_PASSWORD='<CARDDAV_PASSWORD>' -- npx -y carddav-mcp

### What are the best alternatives to Carddav MCP?

The closest alternatives to Carddav MCP are Caldav MCP, Adaptive Cards MCP, Imap MCP, Outlook Mac MCP and Lettio MCP.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Caldav MCP](https://ai-powered.com/mcp/caldav-mcp-2): Caldav MCP is an open-source MCP server for productivity.
- [Adaptive Cards MCP](https://ai-powered.com/mcp/adaptive-cards-mcp): Adaptive Cards MCP is an open-source MCP server for communication.
- [Imap MCP](https://ai-powered.com/mcp/imap-mcp): Imap MCP is an open-source MCP server for communication.
- [Outlook Mac MCP](https://ai-powered.com/mcp/outlook-mac-mcp): Outlook Mac MCP is an open-source MCP server for communication.
- [Lettio MCP](https://ai-powered.com/mcp/lettio-mcp): Lettio MCP is an open-source MCP server for communication.
- [Ms Contacts MCP](https://ai-powered.com/mcp/ms-contacts-mcp): Ms Contacts MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/carddav-mcp-2
