Gesher
Free, open-source MCP servers that let Claude, Codex, Cursor or any MCP client read and edit seven Apple apps on a Mac, including Notes tables, Reminders smart lists and Freeform boards.
문서
Gesher
Let Claude, Codex or Cursor write to Apple Notes, Reminders, Calendar and Freeform: Notes tables and tags, Reminders sections and smart lists, and Freeform boards.
One install for seven apps, with Contacts, Weather and Maps too. The apps can stay closed. A native Swift CLI and MCP server per app, 119 tools.
Install
-
Claude Desktop, one app at a time: download
gesher-<app>-1.1.0.mcpbfrom the latest release and open it; Claude Desktop installs it as an extension. Each bundle holds one app, and macOS asks for its permission again after each update. -
Let your agent do it: paste this into Claude Code, Codex or Cursor:
Install Gesher on my Mac by following https://raw.githubusercontent.com/EphraimElgrabli/gesher/main/docs/install.md -
Terminal, all seven apps: installs every app, connects the AI apps you choose (Claude Code and Codex also get the Gesher plugins and skills), and keeps permissions across updates:
curl -fsSL https://raw.githubusercontent.com/EphraimElgrabli/gesher/main/install.sh | bashThen, in a new Terminal window, run
gesher permissionsand click Allow. Notes and Freeform also need one drag into Full Disk Access, and Gesher opens that window for you. Restart your AI app. Permissions · Other AI apps
[!NOTE] Requirements & trust
- Apple silicon Mac with macOS 26 or later; tested on macOS 27. Gesher uses private frameworks Apple doesn't document for third-party use, so a macOS update can break parts of it;
gesher doctorshows what is affected. Experimental and maintained: report breakage.- The installer needs no
sudo. It installs into~/.local(layout), adds one PATH line to your shell profile (code), may create a code-signing certificate in your login keychain so permissions survive updates, which asks for your password (code), and edits only thegesher-*entries of the AI apps you pick, backing each file up first (code).- The download is checked against its published SHA-256 before anything is installed (code).
- Gesher never writes Apple's databases directly: every change goes through the app's own frameworks and is read back to check it.
Try it
- "Plan my Friday: check the weather, find a free hour for a run, and put my errands in a 'Friday' section of my Errands list."
- "Turn my Lisbon trip note into a packing list in Reminders, due the day before the flight, and add a Passport row to the note's packing table."
- "Which of my Freeform boards mentions the venue? Add today's agenda to it as a text box."
- "Make a smart list of everything tagged #home that's due this week."
- "Will it rain before my 6 pm run? If so, find a café within a 5-minute walk of the office instead."
With iCloud, the changes show up on your iPhone too.
Why Gesher
I built Gesher for my own work. I wanted to stay in Apple's apps instead of adding more apps and subscriptions, and to finally have the assistant I wanted Siri to be. The technical challenge interested me too.
- Features the public APIs don't have. Gesher calls the frameworks Apple's apps are built on, including private frameworks Apple doesn't document for third-party use (a macOS update may break them). 64 of its 119 tools do something no public Apple framework offers, like Reminders sections and smart lists, Notes tags and tables, and Freeform boards. Tool-by-tool comparison · How it works
- The apps can stay closed. No AppleScript, no Shortcuts, no clicking through windows. Freeform opens quietly in the background when an agent adds to a board.
- It checks its work. Every write is read back. Bulk deletes are backed up first, deleted reminders and notes go to Recently Deleted, and Notes edits can be tied to the version the agent read.
What your agent can do
| App | Your agent can… | Tools | |
|---|---|---|---|
| Reminders | add, complete and organize tasks: lists, sections, tags, subtasks, smart lists | 28 | |
| Calendar | read your agenda, find free time, create and move events, answer invitations | 17 | |
| Contacts | find people by name, phone or email, and update cards | 21 | |
| Notes | read and write notes as Markdown, with checklists, tables and tags | 31 | |
| Maps | search places, see opening hours, plan routes and travel times (read-only) | 6 | |
| Weather | check the forecast hour by hour, air quality and severe-weather alerts; minute-by-minute rain in some countries | 10 | |
| Freeform | search every board, create boards, add text, links, images and files | 6 |
Every app is also a command-line tool, for example calendar-cli agenda tomorrow. Each app's README lists its commands.
How it compares
Other good projects cover some of the same apps. Checked against each project's README and repository on 17 November 2026; corrections are welcome in an issue.
| Reminders sections & smart lists | Notes tags & tables | Freeform | Weather / Maps | Apps can stay closed | Install | Maintained | |
|---|---|---|---|---|---|---|---|
| Gesher | ✓ | ✓ | ✓ | ✓ / ✓ | ✓ | .mcpb per app, installer, or ask your agent | ✓ |
| RemCTL | ✓ | — | — | — / — | ✓ | notarized .dmg; then .mcpb or Claude Code plugin | ✓ |
| iMCP | — | — (reads only) | — | ✓ / ✓ | ✓ | app download or Homebrew | ✓ |
| apple-mcp | — | — | — | — / ✓ | — | .dxt, npx, bunx | — (archived August 2025) |
| mcp-server-apple-events | — | — | — | — / — | ✓ | npx | ✓ |
| apple-notes-mcp | — | ✓ | — | — / — | — | npx, Claude Code plugin | ✓ |
| mcp-ical | — | — | — | — / — | ✓ | git clone + uv | — (last commit April 2025) |
| Claude's Apple Notes connector | — | — | — | — / — | not stated | one click in Claude's directory | ✓ |
- What they do that Gesher doesn't: RemCTL is Reminders only and goes further there (rich links, Groceries lists, urgent reminders, a notarized installer, a Reminders workspace in Codex), also through Apple's private ReminderKit. iMCP covers Messages, Mail and current location as well, and reads notes (tables included) from the Notes database without writing them. apple-mcp also covers Messages and Mail, and its Maps tools can save favorites and guides (Gesher's Maps is read-only). mcp-server-apple-events covers Reminders and Calendar with priorities, tags and subtasks. apple-notes-mcp is Notes only and goes deeper there in places (exports, audio transcripts, a query language); it does tags, checklists and tables through Apple Shortcuts and AppleScript. mcp-ical covers Calendar. Claude's connector lists, reads, adds and updates notes.
- Apps can stay closed: AppleScript-based servers (apple-mcp, apple-notes-mcp) drive the app, so macOS opens it. RemCTL, iMCP (whose own menu-bar app runs), the EventKit-based servers (mcp-server-apple-events, mcp-ical) and Gesher don't need the app running; Gesher opens Freeform in the background only to add content to a board.
Good to know
- Privacy: Gesher itself runs on your Mac, with no Gesher servers, accounts or telemetry. Maps and Weather use Apple's services; whatever you share with an agent goes to its provider.
- Stability: the frameworks Gesher uses aren't a stable API, so a macOS update can break parts of it. Gesher then stops with a clear error, and
gesher doctorshows what's affected. Limitations - Trust: each release is built from its tagged commit and published with a
.sha256file, which the installer checks. Security - Questions: FAQ, including how Gesher differs from AppleScript-based MCP servers.
- Other languages: עברית · 简体中文 · 日本語 · more
I'm Ephraim Elgrabli. I built Gesher for my own work and share it under GPL-3.0. Gesher (גשר) is Hebrew for bridge. Bug reports are welcome, especially after macOS updates (open an issue); pull requests are welcome but reviewed slowly (CONTRIBUTING); questions go in Discussions; security reports go through private reporting. Not affiliated with Apple Inc. · Legal notes






