Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mcp-server==0.12.1",
        "--local"
      ],
      "env": {
        "ICLOUD_USERNAME": "${ICLOUD_USERNAME}",
        "ICLOUD_APP_PASSWORD": "${ICLOUD_APP_PASSWORD}",
        "DEFAULT_TIMEZONE": "UTC",
        "SEND_REQUIRES_APPROVAL": "true",
        "WARMUP_ON_START": "true",
        "TOOL_WORKERS": "8"
      }
    }
  }
}

claude mcp add icloud-mcp -e "ICLOUD_USERNAME=${ICLOUD_USERNAME}" -e "ICLOUD_APP_PASSWORD=${ICLOUD_APP_PASSWORD}" -e "DEFAULT_TIMEZONE=UTC" -e "SEND_REQUIRES_APPROVAL=true" -e "WARMUP_ON_START=true" -e "TOOL_WORKERS=8" -- uvx icloud-mcp-server==0.12.1 --local

[mcp_servers.icloud-mcp]
command = "uvx"
args = ["icloud-mcp-server==0.12.1", "--local"]
env = { "ICLOUD_USERNAME" = "${ICLOUD_USERNAME}", "ICLOUD_APP_PASSWORD" = "${ICLOUD_APP_PASSWORD}", "DEFAULT_TIMEZONE" = "UTC", "SEND_REQUIRES_APPROVAL" = "true", "WARMUP_ON_START" = "true", "TOOL_WORKERS" = "8" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "icloud-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "icloud-mcp-server==0.12.1",
        "--local"
      ],
      "enabled": true,
      "environment": {
        "ICLOUD_USERNAME": "{env:ICLOUD_USERNAME}",
        "ICLOUD_APP_PASSWORD": "{env:ICLOUD_APP_PASSWORD}",
        "DEFAULT_TIMEZONE": "UTC",
        "SEND_REQUIRES_APPROVAL": "true",
        "WARMUP_ON_START": "true",
        "TOOL_WORKERS": "8"
      }
    }
  }
}

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mcp-server==0.12.1",
        "--local"
      ],
      "env": {
        "ICLOUD_USERNAME": "${ICLOUD_USERNAME}",
        "ICLOUD_APP_PASSWORD": "${ICLOUD_APP_PASSWORD}",
        "DEFAULT_TIMEZONE": "UTC",
        "SEND_REQUIRES_APPROVAL": "true",
        "WARMUP_ON_START": "true",
        "TOOL_WORKERS": "8"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=icloud-mcp&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJpY2xvdWQtbWNwLXNlcnZlcj09MC4xMi4xIiwiLS1sb2NhbCJdLCJlbnYiOnsiSUNMT1VEX1VTRVJOQU1FIjoiJHtJQ0xPVURfVVNFUk5BTUV9IiwiSUNMT1VEX0FQUF9QQVNTV09SRCI6IiR7SUNMT1VEX0FQUF9QQVNTV09SRH0iLCJERUZBVUxUX1RJTUVaT05FIjoiVVRDIiwiU0VORF9SRVFVSVJFU19BUFBST1ZBTCI6InRydWUiLCJXQVJNVVBfT05fU1RBUlQiOiJ0cnVlIiwiVE9PTF9XT1JLRVJTIjoiOCJ9fQ%3D%3D"
}

{
  "servers": {
    "icloud-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "icloud-mcp-server==0.12.1",
        "--local"
      ],
      "env": {
        "ICLOUD_USERNAME": "${ICLOUD_USERNAME}",
        "ICLOUD_APP_PASSWORD": "${ICLOUD_APP_PASSWORD}",
        "DEFAULT_TIMEZONE": "UTC",
        "SEND_REQUIRES_APPROVAL": "true",
        "WARMUP_ON_START": "true",
        "TOOL_WORKERS": "8"
      }
    }
  }
}

{
  "mcpServers": {
    "icloud-mcp": {
      "command": "uvx",
      "args": [
        "icloud-mcp-server==0.12.1",
        "--local"
      ],
      "env": {
        "ICLOUD_USERNAME": "${ICLOUD_USERNAME}",
        "ICLOUD_APP_PASSWORD": "${ICLOUD_APP_PASSWORD}",
        "DEFAULT_TIMEZONE": "UTC",
        "SEND_REQUIRES_APPROVAL": "true",
        "WARMUP_ON_START": "true",
        "TOOL_WORKERS": "8"
      }
    }
  }
}

extensions:
  "icloud-mcp":
    enabled: true
    name: "icloud-mcp"
    type: stdio
    cmd: "uvx"
    args:
      - "icloud-mcp-server==0.12.1"
      - "--local"
    envs:
      "ICLOUD_USERNAME": "${ICLOUD_USERNAME}"
      "ICLOUD_APP_PASSWORD": "${ICLOUD_APP_PASSWORD}"
      "DEFAULT_TIMEZONE": "UTC"
      "SEND_REQUIRES_APPROVAL": "true"
      "WARMUP_ON_START": "true"
      "TOOL_WORKERS": "8"
    timeout: 300

Placeholders to fill from your own secret store: ${ICLOUD_APP_PASSWORD}. The registry never accepts secret values.

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25

n/a
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygienen/a · weight 30

n/a
tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)

stabilityn/a · weight 15

n/a
stability.changes, stability.rug_pulltool list unknown

dependencies100 · weight 15

pass
deps.known_vulnsno known advisory in 51 resolved packages
pass
deps.mcp_sdk_versionmcp 2.2.0, no known advisory
pass
deps.resolvable[email protected] resolved: 51 packages

Tool list unknown · checked 2026-10-20 15:26 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 96 / 100

provenance90

livenessn/a

freshness100

hygiene100

+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-24d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] PyPI50 dependencies, resolved · MCP SDK mcp 2.2.0 · advisories checked 2026-10-19

No known advisory affects this dependency graph.

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

package	registry	version	runtime	secrets
`icloud-mcp-server`	pypi	0.12.1	uvx	`ICLOUD_APP_PASSWORD`

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "io.github.epinethrone/icloud-mcp",
  "title": "iCloud",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "0.12.1",
  "packages": [
    {
      "version": "0.12.1",
      "transport": {
        "type": "stdio"
      },
      "identifier": "icloud-mcp-server",
      "runtimeHint": "uvx",
      "registryType": "pypi",
      "registryBaseUrl": "https://pypi.org",
      "packageArguments": [
        {
          "type": "positional",
          "value": "--local",
          "description": "Run over stdio for a desktop client on this computer."
        }
      ],
      "environmentVariables": [
        {
          "name": "ICLOUD_USERNAME",
          "isRequired": true,
          "description": "Your Apple Account email."
        },
        {
          "name": "ICLOUD_APP_PASSWORD",
          "isSecret": true,
          "isRequired": true,
          "description": "An app-specific password from account.apple.com (not your Apple password)."
        },
        {
          "name": "ICLOUD_DISPLAY_NAME",
          "description": "Name shown on mail you send."
        },
        {
          "name": "DEFAULT_TIMEZONE",
          "default": "UTC",
          "description": "IANA timezone for calendar times, e.g. Europe/Berlin."
        },
        {
          "name": "SEND_REQUIRES_APPROVAL",
          "choices": [
            "true",
            "false"
          ],
          "default": "true",
          "description": "true: mail Claude sends is saved to Drafts for you to send. false: sent directly."
        },
        {
          "name": "AGENT_NOTES_FILE",
          "description": "Path to a file with your own rules for agents, added to the instructions."
        },
        {
          "name": "OWNER_ADDRESSES",
          "description": "Your aliases, comma-separated, so invitations to them count as yours."
        },
        {
          "name": "WARMUP_ON_START",
          "choices": [
            "true",
            "false"
          ],
          "default": "true",
          "description": "Sign in to mail, calendar and contacts in the background at start."
        },
        {
          "name": "TOOL_WORKERS",
          "default": "8",
          "description": "Tool calls that can run at the same time."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/epinethrone/icloud-mcp",
    "source": "github"
  },
  "websiteUrl": "https://github.com/epinethrone/icloud-mcp",
  "description": "iCloud Mail, Calendar, Contacts, Reminders, Notes and Drive. Approval-first, self-hosted or local."
}