Skip to content
MCP server

Carddav MCP

MCP server giving AI assistants read and write access to CardDAV address books

Runs locally
Install

Carddav MCP is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, Self-hosted
Runs
Locally
Version
0.1.2
Listing updated

Similar MCP servers

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • CARDDAV_BASE_URLBase URL of the CardDAV server (e.g. https://carddav.example.com)Required
  • CARDDAV_USERNAMEUsername for CardDAV authenticationRequired
  • CARDDAV_PASSWORDPassword for CardDAV authenticationRequired

About Carddav MCP

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.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Free and MIT-licensed; runs locally against your own CardDAV server.

Carddav MCP 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.

How AIPoweredBot checks servers