# 安装 io.github.eodozzy/icloud-mcp

- 类型: MCP 工具
- 说明: 以只读方式接入 iCloud 邮件、日历和联系人，便于查询与整合办公信息
- 仓库: https://github.com/eodozzy/icloud-mcp

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

### Claude Code
```
请帮我安装 askskill 上的 "io.github.eodozzy/icloud-mcp" MCP 服务：
执行：claude mcp add 'io-github-eodozzy-icloud-mcp' -- npx -y icloud-mcp
```

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

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

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

### Claude Code
```bash
claude mcp add --env ICLOUD_USERNAME=YOUR_VALUE --env ICLOUD_KEYRING_SERVICE=YOUR_VALUE --env ICLOUD_APP_PASSWORD=YOUR_VALUE --env ICLOUD_ENABLE_WRITES=YOUR_VALUE --env ICLOUD_IMAP_HOST=YOUR_VALUE --env ICLOUD_IMAP_PORT=YOUR_VALUE --env ICLOUD_SMTP_HOST=YOUR_VALUE --env ICLOUD_SMTP_PORT=YOUR_VALUE --env ICLOUD_CALDAV_URL=YOUR_VALUE --env ICLOUD_CARDDAV_URL=YOUR_VALUE --env ICLOUD_TZ=YOUR_VALUE --transport stdio io-github-eodozzy-icloud-mcp -- npx -y icloud-mcp
```
需要环境变量：ICLOUD_USERNAME, ICLOUD_KEYRING_SERVICE, ICLOUD_APP_PASSWORD, ICLOUD_ENABLE_WRITES, ICLOUD_IMAP_HOST, ICLOUD_IMAP_PORT, ICLOUD_SMTP_HOST, ICLOUD_SMTP_PORT, ICLOUD_CALDAV_URL, ICLOUD_CARDDAV_URL, ICLOUD_TZ

### Codex
```bash
codex mcp add --env ICLOUD_USERNAME=YOUR_VALUE --env ICLOUD_KEYRING_SERVICE=YOUR_VALUE --env ICLOUD_APP_PASSWORD=YOUR_VALUE --env ICLOUD_ENABLE_WRITES=YOUR_VALUE --env ICLOUD_IMAP_HOST=YOUR_VALUE --env ICLOUD_IMAP_PORT=YOUR_VALUE --env ICLOUD_SMTP_HOST=YOUR_VALUE --env ICLOUD_SMTP_PORT=YOUR_VALUE --env ICLOUD_CALDAV_URL=YOUR_VALUE --env ICLOUD_CARDDAV_URL=YOUR_VALUE --env ICLOUD_TZ=YOUR_VALUE io-github-eodozzy-icloud-mcp -- npx -y icloud-mcp
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-eodozzy-icloud-mcp]
command = "npx"
args = ["-y","icloud-mcp"]

[mcp_servers.io-github-eodozzy-icloud-mcp.env]
ICLOUD_USERNAME = "YOUR_VALUE"
ICLOUD_KEYRING_SERVICE = "YOUR_VALUE"
ICLOUD_APP_PASSWORD = "YOUR_VALUE"
ICLOUD_ENABLE_WRITES = "YOUR_VALUE"
ICLOUD_IMAP_HOST = "YOUR_VALUE"
ICLOUD_IMAP_PORT = "YOUR_VALUE"
ICLOUD_SMTP_HOST = "YOUR_VALUE"
ICLOUD_SMTP_PORT = "YOUR_VALUE"
ICLOUD_CALDAV_URL = "YOUR_VALUE"
ICLOUD_CARDDAV_URL = "YOUR_VALUE"
ICLOUD_TZ = "YOUR_VALUE"
```
需要环境变量：ICLOUD_USERNAME, ICLOUD_KEYRING_SERVICE, ICLOUD_APP_PASSWORD, ICLOUD_ENABLE_WRITES, ICLOUD_IMAP_HOST, ICLOUD_IMAP_PORT, ICLOUD_SMTP_HOST, ICLOUD_SMTP_PORT, ICLOUD_CALDAV_URL, ICLOUD_CARDDAV_URL, ICLOUD_TZ

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-eodozzy-icloud-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "icloud-mcp"
      ],
      "env": {
        "ICLOUD_USERNAME": "YOUR_VALUE",
        "ICLOUD_KEYRING_SERVICE": "YOUR_VALUE",
        "ICLOUD_APP_PASSWORD": "YOUR_VALUE",
        "ICLOUD_ENABLE_WRITES": "YOUR_VALUE",
        "ICLOUD_IMAP_HOST": "YOUR_VALUE",
        "ICLOUD_IMAP_PORT": "YOUR_VALUE",
        "ICLOUD_SMTP_HOST": "YOUR_VALUE",
        "ICLOUD_SMTP_PORT": "YOUR_VALUE",
        "ICLOUD_CALDAV_URL": "YOUR_VALUE",
        "ICLOUD_CARDDAV_URL": "YOUR_VALUE",
        "ICLOUD_TZ": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-eodozzy-icloud-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImljbG91ZC1tY3AiXSwiZW52Ijp7IklDTE9VRF9VU0VSTkFNRSI6IllPVVJfVkFMVUUiLCJJQ0xPVURfS0VZUklOR19TRVJWSUNFIjoiWU9VUl9WQUxVRSIsIklDTE9VRF9BUFBfUEFTU1dPUkQiOiJZT1VSX1ZBTFVFIiwiSUNMT1VEX0VOQUJMRV9XUklURVMiOiJZT1VSX1ZBTFVFIiwiSUNMT1VEX0lNQVBfSE9TVCI6IllPVVJfVkFMVUUiLCJJQ0xPVURfSU1BUF9QT1JUIjoiWU9VUl9WQUxVRSIsIklDTE9VRF9TTVRQX0hPU1QiOiJZT1VSX1ZBTFVFIiwiSUNMT1VEX1NNVFBfUE9SVCI6IllPVVJfVkFMVUUiLCJJQ0xPVURfQ0FMREFWX1VSTCI6IllPVVJfVkFMVUUiLCJJQ0xPVURfQ0FSRERBVl9VUkwiOiJZT1VSX1ZBTFVFIiwiSUNMT1VEX1RaIjoiWU9VUl9WQUxVRSJ9fQ
需要环境变量：ICLOUD_USERNAME, ICLOUD_KEYRING_SERVICE, ICLOUD_APP_PASSWORD, ICLOUD_ENABLE_WRITES, ICLOUD_IMAP_HOST, ICLOUD_IMAP_PORT, ICLOUD_SMTP_HOST, ICLOUD_SMTP_PORT, ICLOUD_CALDAV_URL, ICLOUD_CARDDAV_URL, ICLOUD_TZ