Skip to content
Back to search

ibridge-mcp

iBridge: an MCP server that connects Claude and other AI assistants to your iCloud Mail, Calendar and Contacts. Unofficial; not affiliated with Apple.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/alexandertar--ibridge-mcp/badge.svg)](/listings/alexandertar--ibridge-mcp)

HTML

<a href="/listings/alexandertar--ibridge-mcp"><img src="/api/listings/alexandertar--ibridge-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

You need Rust 1.98 or newer. First create an app-specific password at [account.apple.com](https://account.apple.com) under Sign-In and Security. Use one password per tool, so you can revoke it on its own.

cargo install ibridge

Or build from a checkout:

git clone https://github.com/AlexanderTar/ibridge-mcp
cd ibridge-mcp
cargo install --path crates/ibridge

Or install straight from git: `cargo install --git https://github.com/AlexanderTar/ibridge-mcp ibridge`.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 113 lines
  1. <picture>
  2. <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/AlexanderTar/ibridge-mcp/main/site/design/readme-cover/2-chat-dark@2x.png">
  3. <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/AlexanderTar/ibridge-mcp/main/site/design/readme-cover/2-chat-light@2x.png">
  4. <img src="https://raw.githubusercontent.com/AlexanderTar/ibridge-mcp/main/site/design/readme-cover/2-chat-light@2x.png" alt="iBridge: your iCloud, in your AI assistant. Mail, Calendar and Contacts." width="100%">
  5. </picture>
  6. # iBridge
  7. [![CI](https://github.com/AlexanderTar/ibridge-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/AlexanderTar/ibridge-mcp/actions/workflows/ci.yml)
  8. [![License: Apache-2.0](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
  9. [![crates.io](https://img.shields.io/crates/v/ibridge.svg)](https://crates.io/crates/ibridge)
  10. [![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.AlexanderTar%2Fibridge-informational)](https://registry.modelcontextprotocol.io/?q=io.github.AlexanderTar%2Fibridge)
  11. [![Glama MCP server](https://glama.ai/mcp/servers/AlexanderTar/ibridge-mcp/badges/score.svg)](https://glama.ai/mcp/servers/AlexanderTar/ibridge-mcp)
  12. [![Glama MCP connector](https://glama.ai/mcp/connectors/io.github.AlexanderTar/ibridge/badges/score.svg)](https://glama.ai/mcp/connectors/io.github.AlexanderTar/ibridge)
  13. An [MCP](https://modelcontextprotocol.io) server that lets Claude and other MCP clients read, search and manage your iCloud Mail, Calendar and Contacts.
  14. It talks to iCloud over IMAP, SMTP, CalDAV and CardDAV with an app-specific password. Your Apple ID password is never used. Run it on your machine, run your own hosted copy, or use the hosted connector at [ibridge.fyi](https://ibridge.fyi).
  15. iBridge is distributed as source. There are no prebuilt binaries: you build it with Rust, or you use the hosted connector.
  16. ## Tools
  17. - **Mail:** list mailboxes, search, read messages and attachments, create drafts, send, move and set flags.
  18. - **Calendar:** list calendars, search and read events, create, update and delete them.
  19. - **Contacts:** search and read contacts, create, update and delete them.
  20. - **Account:** `account_status` reports which services are reachable.
  21. Tools that change anything are marked as such. Mail, event and contact text reaches the client as plain JSON fields, with hidden characters and hidden HTML removed, and each read tool says where its text comes from.
  22. ## Start read-only
  23. Some tools send mail, move messages, and change or delete events and contacts. While you find out what Claude does with them, run the server read-only: every tool that changes anything is hidden and rejected.
  24. ```sh
  25. ibridge serve --stdio --read-only
  26. ```
  27. Drop `--read-only` once you trust the setup.
  28. ## Install from source
  29. You need Rust 1.98 or newer. First create an app-specific password at [account.apple.com](https://account.apple.com) under Sign-In and Security. Use one password per tool, so you can revoke it on its own.
  30. ```sh
  31. cargo install ibridge
  32. ```
  33. Or build from a checkout:
  34. ```sh
  35. git clone https://github.com/AlexanderTar/ibridge-mcp
  36. cd ibridge-mcp
  37. cargo install --path crates/ibridge
  38. ```
  39. Or install straight from git: `cargo install --git https://github.com/AlexanderTar/ibridge-mcp ibridge`.
  40. ## Connect Claude Code
  41. Store the password in your system keychain, then register the server:
  42. ```sh
  43. ibridge login
  44. claude mcp add ibridge -- ibridge serve --stdio --read-only
  45. ```
  46. `ibridge login` checks the password against iCloud before it stores it, and prints the `claude mcp add` line for your install. `ibridge doctor` checks the keychain, the network and the sign-in for each service.
  47. To keep one server running in the background on macOS or Linux, `ibridge daemon install` starts it on loopback and prints the `claude mcp add --transport http` line, with its bearer token.
  48. ## Connect Claude Desktop
  49. Build the Claude Desktop extension from your own build, in a checkout:
  50. ```sh
  51. cargo build --release -p ibridge
  52. cargo xtask mcpb
  53. ```
  54. That writes `target/mcpb/ibridge-<version>-<platform>.mcpb` (it needs `zip` on your `PATH`). Open the file in Claude Desktop. It asks for your Apple ID and the app-specific password, keeps the password out of the config file and passes it to the server as an environment variable. The extension has no read-only switch; use Claude Code if you want one.
  55. ## Hosted connector
  56. [ibridge.fyi](https://ibridge.fyi) runs iBridge for you, for Claude.ai and other remote MCP clients. Add a custom connector with the URL `https://mcp.ibridge.fyi/mcp`, sign in with Apple, then connect your iCloud address with an app-specific password. It costs US$1.99 per month or US$19.99 per year. Running iBridge on your own machine or self-hosting is free and never gated.
  57. ## Self-host
  58. To run your own hosted server, build the image from a checkout:
  59. ```sh
  60. docker build -t ibridge:src .
  61. ```
  62. [docs/self-host.md](docs/self-host.md) covers running it, sign-in, backups and platforms such as Fly.io and Railway. Read [docs/security-model.md](docs/security-model.md) first: it says what the hosted server stores and where its protection ends.
  63. ## Reminders
  64. The reminders tools read and change old-style reminder lists only. Apple's newer Reminders format is not visible over CalDAV, so iBridge cannot see those lists, and the list tool says so. Calendar events are not affected.
  65. ## Security
  66. Credentials are only ever sent to Apple's iCloud hosts. See [SECURITY.md](SECURITY.md) to report a vulnerability.
  67. ## Contributing
  68. Read [CONTRIBUTING.md](CONTRIBUTING.md) and the [Code of Conduct](CODE_OF_CONDUCT.md). [docs/local-development.md](docs/local-development.md) covers the toolchain, [docs/release.md](docs/release.md) covers releases and [CHANGELOG.md](CHANGELOG.md) lists what changed.
  69. ## Licence
  70. Apache-2.0. See [LICENSE](LICENSE) and [NOTICE](NOTICE). The one exception is Apple's Sign in with Apple logo in `crates/ibridge-hosted/assets/`: it is Apple's artwork, committed unmodified, kept out of the published crate, and not covered by that licence.
  71. mcp-name: io.github.AlexanderTar/ibridge

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.