MCP Servers for macOS Native Applications: Controlling Mail, iMessage, and System Apps Locally

Yes, the awesome-mcp-servers catalog includes a dedicated local MCP server that enables AI agents to interact natively with macOS applications including Mail, iMessage, Calendar, and Finder without requiring cloud services, API keys, or external tokens.

The awesome-mcp-servers repository lists a specialized macOS implementation under its OS Automation section that bridges standard MCP clients to native Apple applications. Located at line 816 in README.md, this entry points to the lanchuske/local-mcp-releases project, marked with the 🍎 (macOS) and 🏠 (local) emoji tags to indicate it runs entirely on the host machine. This server exposes over 80 standardized tools that allow AI assistants to read emails, send iMessages, manage calendar events, and control other system functions through local execution only.

Local MCP Server Architecture

The local-mcp implementation operates as a native binary on macOS, communicating directly with Apple’s scripting bridges (JXA/AppleScript) and underlying application APIs. Unlike cloud-dependent integrations, this architecture ensures all data processing remains on the physical device.

Zero-Trust Security Design

The server requires no tokens, secrets, or external services. It operates on a zero-trust principle where the MCP server only accesses data that the user has explicitly permitted through macOS privacy controls. Because the server binds to localhost:3000 and never transmits data off-device, it eliminates exposure risks associated with third-party cloud APIs.

Standardized Tool Interface

Each macOS application exposes tools following the standard MCP contract methods (list, get, call). The source definitions in src/tools/*.ts (such as src/tools/mail.ts) implement these contracts for specific app functions. Examples include:

  • mail.listAccounts – Enumerate configured Mail.app accounts
  • mail.search – Query messages by content, sender, or date
  • imessage.send – Transmit messages via the Messages app
  • calendar.createEvent – Add entries to Calendar.app

Supported macOS Applications

The local MCP server provides tool coverage for the following native and third-party macOS applications:

  • System Apps: Mail, Messages (iMessage), Calendar, Contacts, Reminders, Notes, Finder, Safari
  • Productivity: OmniFocus, Microsoft Teams, Outlook, OneDrive, Office documents
  • Scope: All operations execute locally without network egress

Installation and Setup

Install the server globally via npm and start the background service:


# Install the server (requires npm ≥ 9)

npm install -g @lanchuske/local-mcp

# Start the MCP server (runs in the background)

local-mcp &

Once running, the server exposes HTTP endpoints on localhost:3000. Any MCP-compatible client (Claude Desktop, Cursor, Windsurf) can automatically discover available tools through the standard protocol handshake.

Usage Examples

Discover available macOS tools by filtering for local scope and Apple OS:


# List available macOS tools (JSON output)

curl -s http://localhost:3000/tools | jq '.tools[] | select(.scope=="🏠" and .os=="🍎") | .name'

Search Apple Mail for messages containing specific terms:

curl -X POST http://localhost:3000/call \
  -H "Content-Type: application/json" \
  -d '{
        "tool": "mail.search",
        "params": { "query": "invoice", "limit": 5 }
      }' | jq '.results'

Send an iMessage to a contact:

curl -X POST http://localhost:3000/call \
  -H "Content-Type: application/json" \
  -d '{
        "tool": "imessage.send",
        "params": { "to": "+15551234567", "body": "Hello from my AI assistant!" }
      }' | jq '.status'

These examples demonstrate direct HTTP calls to the local server, though most users will interact through their MCP client’s native interface rather than raw curl commands.

Client Compatibility

Because local-mcp implements the standard MCP wire protocol, it integrates automatically with any MCP-compatible client. The package.json in the source repository defines the entry point and dependencies required for the server to initialize. Once configured in a client like Claude Desktop, the AI can discover and invoke macOS tools without additional manual configuration.

Summary

  • The awesome-mcp-servers repository lists a local MCP implementation for macOS at README.md#L816 under the OS Automation section
  • lanchuske/local-mcp-releases provides over 80 tools for native macOS applications including Mail, iMessage, and Calendar
  • The server runs entirely locally (🍎 + 🏠 tags) with no cloud component, requiring zero API keys or tokens
  • Installation occurs via npm install -g @lanchuske/local-mcp, exposing an HTTP interface on localhost:3000
  • Tools follow standard MCP contracts (list, get, call) and are defined in TypeScript source files like src/tools/mail.ts
  • Compatible with any MCP client including Claude Desktop, Cursor, and Windsurf

Frequently Asked Questions

Do MCP servers for macOS require cloud access or API keys?

No. The local MCP server listed in awesome-mcp-servers operates on a zero-trust design that requires no tokens, secrets, or external services. It runs as a native binary on your Mac and communicates directly with Apple applications via JXA/AppleScript bridges, keeping all data processing on-device.

Which macOS applications can AI agents control through MCP?

The local implementation supports Mail, iMessage (Messages), Calendar, Contacts, Reminders, Notes, Finder, Safari, OmniFocus, Microsoft Teams, Outlook, OneDrive, and Office documents. Over 80 specific tools are available, such as mail.search for querying emails and imessage.send for transmitting messages.

How do I install the MCP server for macOS system apps?

Install via npm using npm install -g @lanchuske/local-mcp, then start the server with local-mcp &. The server binds to localhost:3000 and exposes standard MCP endpoints. MCP-compatible clients automatically discover available tools through the protocol's capability negotiation.

Is it safe to grant an MCP server access to my Mail and Messages?

The server only accesses data that macOS privacy controls have already permitted for your user account. Since it runs locally without network egress and requires no external authentication tokens, it eliminates the risk of cloud data breaches. However, standard macOS permissions still apply—apps like Mail and Messages will prompt for accessibility or automation permissions before the MCP server can interact with them.

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"

Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →