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

Gesher: Your AI, meet your Mac.

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.

Latest release macOS · Apple silicon Works with any MCP client License: GPL-3.0

Install

  • Claude Desktop, one app at a time: download gesher-<app>-1.1.0.mcpb from 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 | bash
    

    Then, in a new Terminal window, run gesher permissions and 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 doctor shows 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 the gesher-* 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

AppYour agent can…Tools
Remindersadd, complete and organize tasks: lists, sections, tags, subtasks, smart lists28
Calendarread your agenda, find free time, create and move events, answer invitations17
Contactsfind people by name, phone or email, and update cards21
Notesread and write notes as Markdown, with checklists, tables and tags31
Mapssearch places, see opening hours, plan routes and travel times (read-only)6
Weathercheck the forecast hour by hour, air quality and severe-weather alerts; minute-by-minute rain in some countries10
Freeformsearch every board, create boards, add text, links, images and files6

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 listsNotes tags & tablesFreeformWeather / MapsApps can stay closedInstallMaintained
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 statedone 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 doctor shows what's affected. Limitations
  • Trust: each release is built from its tagged commit and published with a .sha256 file, 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