# 安装 CardDAV address books

- 类型: MCP 工具
- 说明: Read and write CardDAV address books: contacts, groups and photos over the open standard
- 仓库: https://github.com/ni-c/carddav-mcp

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "CardDAV address books" MCP 服务：
执行：claude mcp add 'io-github-ni-c-carddav-mcp' -- npx -y @ni-c/carddav-mcp
```

### Codex
```
请帮我安装 askskill 上的 "CardDAV address books" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-ni-c-carddav-mcp]
command = "npx"
args = ["-y","@ni-c/carddav-mcp"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "CardDAV address books" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-ni-c-carddav-mcp": { "command": "npx", "args": ["-y","@ni-c/carddav-mcp"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env CARDDAV_URL=YOUR_VALUE --env CARDDAV_USERNAME=YOUR_VALUE --env CARDDAV_PASSWORD=YOUR_VALUE --env CARDDAV_TOKEN=YOUR_VALUE --env CARDDAV_ADDRESSBOOKS=YOUR_VALUE --env CARDDAV_MAX_CONTACTS=YOUR_VALUE --env CARDDAV_READ_ONLY=YOUR_VALUE --env CARDDAV_INSECURE_TLS=YOUR_VALUE --env CARDDAV_ALLOW_PLAINTEXT=YOUR_VALUE --env CARDDAV_ALLOW_TOOLS=YOUR_VALUE --env CARDDAV_DENY_TOOLS=YOUR_VALUE --env ELICITATION=YOUR_VALUE --transport stdio io-github-ni-c-carddav-mcp -- npx -y @ni-c/carddav-mcp
```
需要环境变量：CARDDAV_URL, CARDDAV_USERNAME, CARDDAV_PASSWORD, CARDDAV_TOKEN, CARDDAV_ADDRESSBOOKS, CARDDAV_MAX_CONTACTS, CARDDAV_READ_ONLY, CARDDAV_INSECURE_TLS, CARDDAV_ALLOW_PLAINTEXT, CARDDAV_ALLOW_TOOLS, CARDDAV_DENY_TOOLS, ELICITATION

### Codex
```bash
codex mcp add --env CARDDAV_URL=YOUR_VALUE --env CARDDAV_USERNAME=YOUR_VALUE --env CARDDAV_PASSWORD=YOUR_VALUE --env CARDDAV_TOKEN=YOUR_VALUE --env CARDDAV_ADDRESSBOOKS=YOUR_VALUE --env CARDDAV_MAX_CONTACTS=YOUR_VALUE --env CARDDAV_READ_ONLY=YOUR_VALUE --env CARDDAV_INSECURE_TLS=YOUR_VALUE --env CARDDAV_ALLOW_PLAINTEXT=YOUR_VALUE --env CARDDAV_ALLOW_TOOLS=YOUR_VALUE --env CARDDAV_DENY_TOOLS=YOUR_VALUE --env ELICITATION=YOUR_VALUE io-github-ni-c-carddav-mcp -- npx -y @ni-c/carddav-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-ni-c-carddav-mcp]
command = "npx"
args = ["-y","@ni-c/carddav-mcp"]

[mcp_servers.io-github-ni-c-carddav-mcp.env]
CARDDAV_URL = "YOUR_VALUE"
CARDDAV_USERNAME = "YOUR_VALUE"
CARDDAV_PASSWORD = "YOUR_VALUE"
CARDDAV_TOKEN = "YOUR_VALUE"
CARDDAV_ADDRESSBOOKS = "YOUR_VALUE"
CARDDAV_MAX_CONTACTS = "YOUR_VALUE"
CARDDAV_READ_ONLY = "YOUR_VALUE"
CARDDAV_INSECURE_TLS = "YOUR_VALUE"
CARDDAV_ALLOW_PLAINTEXT = "YOUR_VALUE"
CARDDAV_ALLOW_TOOLS = "YOUR_VALUE"
CARDDAV_DENY_TOOLS = "YOUR_VALUE"
ELICITATION = "YOUR_VALUE"
```
需要环境变量：CARDDAV_URL, CARDDAV_USERNAME, CARDDAV_PASSWORD, CARDDAV_TOKEN, CARDDAV_ADDRESSBOOKS, CARDDAV_MAX_CONTACTS, CARDDAV_READ_ONLY, CARDDAV_INSECURE_TLS, CARDDAV_ALLOW_PLAINTEXT, CARDDAV_ALLOW_TOOLS, CARDDAV_DENY_TOOLS, ELICITATION

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-ni-c-carddav-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@ni-c/carddav-mcp"
      ],
      "env": {
        "CARDDAV_URL": "YOUR_VALUE",
        "CARDDAV_USERNAME": "YOUR_VALUE",
        "CARDDAV_PASSWORD": "YOUR_VALUE",
        "CARDDAV_TOKEN": "YOUR_VALUE",
        "CARDDAV_ADDRESSBOOKS": "YOUR_VALUE",
        "CARDDAV_MAX_CONTACTS": "YOUR_VALUE",
        "CARDDAV_READ_ONLY": "YOUR_VALUE",
        "CARDDAV_INSECURE_TLS": "YOUR_VALUE",
        "CARDDAV_ALLOW_PLAINTEXT": "YOUR_VALUE",
        "CARDDAV_ALLOW_TOOLS": "YOUR_VALUE",
        "CARDDAV_DENY_TOOLS": "YOUR_VALUE",
        "ELICITATION": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-ni-c-carddav-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBuaS1jL2NhcmRkYXYtbWNwIl0sImVudiI6eyJDQVJEREFWX1VSTCI6IllPVVJfVkFMVUUiLCJDQVJEREFWX1VTRVJOQU1FIjoiWU9VUl9WQUxVRSIsIkNBUkREQVZfUEFTU1dPUkQiOiJZT1VSX1ZBTFVFIiwiQ0FSRERBVl9UT0tFTiI6IllPVVJfVkFMVUUiLCJDQVJEREFWX0FERFJFU1NCT09LUyI6IllPVVJfVkFMVUUiLCJDQVJEREFWX01BWF9DT05UQUNUUyI6IllPVVJfVkFMVUUiLCJDQVJEREFWX1JFQURfT05MWSI6IllPVVJfVkFMVUUiLCJDQVJEREFWX0lOU0VDVVJFX1RMUyI6IllPVVJfVkFMVUUiLCJDQVJEREFWX0FMTE9XX1BMQUlOVEVYVCI6IllPVVJfVkFMVUUiLCJDQVJEREFWX0FMTE9XX1RPT0xTIjoiWU9VUl9WQUxVRSIsIkNBUkREQVZfREVOWV9UT09MUyI6IllPVVJfVkFMVUUiLCJFTElDSVRBVElPTiI6IllPVVJfVkFMVUUifX0
需要环境变量：CARDDAV_URL, CARDDAV_USERNAME, CARDDAV_PASSWORD, CARDDAV_TOKEN, CARDDAV_ADDRESSBOOKS, CARDDAV_MAX_CONTACTS, CARDDAV_READ_ONLY, CARDDAV_INSECURE_TLS, CARDDAV_ALLOW_PLAINTEXT, CARDDAV_ALLOW_TOOLS, CARDDAV_DENY_TOOLS, ELICITATION
