Skip to main content
Glama
Sign In
localbridge

localbridge

by contessid
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

localbridge

Let AI clients use the apps on your Mac, locally, with your permission.

localbridge is a small MCP server that runs on your Mac and gives AI clients tools for Mail, Calendar, Reminders, Notes, your files and (optionally) Microsoft Teams. A menu bar app shows what it is doing.

What it can do

  • Mail: search (full text, in under a second), read, draft, reply, forward, move, flag.

  • Calendar & Reminders: list, create, update and delete events and reminders.

  • Notes: search, read, create and edit Apple Notes.

  • Files: search with Spotlight, read PDFs and documents, move, rename, write; deleting means moving to the Trash.

  • Teams (optional): chats, channels, search and meeting transcripts, limited to an allowlist and historical depth you choose.

Anything that reaches other people (sending an email or a Teams message, changing a meeting with attendees) always asks for your confirmation. Text from emails, messages and files is marked as third-party content, so the AI treats it as data, not as instructions.

Related MCP server: macos-mcp

Install

Requires macOS 14 or later, uv and the Xcode Command Line Tools (xcode-select --install).

git clone https://github.com/contessid/localbridge.git
cd localbridge
scripts/install.sh                      # installs the service and the menu bar app
uv run scripts/register_clients.py all  # adds localbridge to Claude Code and Codex

Then give Full Disk Access to ~/Applications/Localbridge.app (System Settings → Privacy & Security → Full Disk Access), which Mail's data needs. Calendar, Reminders and Automation are asked the first time they are used. The menu bar icon shows anything that is still missing, with a button to fix it.

Settings

Everything is in the menu bar app → Settings…: turn services on or off, choose the folders the file tools may use, connect Microsoft 365, register AI clients, and see the activity log (tool name, time and result, never the content).

Teams (optional)

Teams works through Microsoft Graph with delegated permissions: localbridge sees only what you see, and only what you put in the Teams access allowlist, each entry with its own history limit. It needs an app registered in your Microsoft 365 tenant: see the setup guide.

Privacy

  • The server listens only on 127.0.0.1, protected by a token.

  • No telemetry, no cloud relay; logs stay in ~/Library/Logs/localbridge.

  • macOS permissions belong to Localbridge.app, not to your terminal.

Uninstall

scripts/uninstall.sh            # removes the apps and their background agents, keeps your settings
scripts/uninstall.sh --purge    # also deletes settings, indexes and the Microsoft 365 session

More

License

MIT

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Local MCP

      colibird-ai
      F
      license
      C
      quality
      B
      maintenance
      Local tools that let your AI use Mail, Calendar, Contacts, Teams, Slack, WhatsApp, OneDrive, Google Drive, Notion, Outlook and Office files on Mac and Windows. Runs on your computer. Works with Claude, ChatGPT, Codex, Cursor and other MCP clients.
      404
      80
      -

    • macos-mcp

      krmj22
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI assistants to read, create, update, and delete data in macOS apps (Reminders, Calendar, Notes, Mail, Messages, Contacts) via natural language, using EventKit, JXA, and SQLite backends.
      45 npm
      10
      MIT

    • Apple Mail MCP Server

      LeChabrax
      A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to read, search, send, and manage email on macOS through programmatic access to Apple Mail.
      29
      MIT

    • Apple Mail, Calendar & Notes

      ipsupport-llc
      A
      license
      Not graded
      quality
      B
      maintenance
      Enables an AI assistant to read, search, triage and send mail, manage calendars and browse, write and organize notes by driving the Mail, Calendar and Notes apps already on a Mac, with no dependencies, no network code and only two permission prompts.
      MIT