Carddav MCP
MCP server giving AI assistants read and write access to CardDAV address books
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-mcpAdd 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)RequiredCARDDAV_USERNAMEUsername for CardDAV authenticationRequiredCARDDAV_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.