Connect your macOS digital life with AI using an MCP server that provides secure access to calendar, contacts, location, maps, messages, reminders, and weather data via the Model Context Protocol for seamless integration with compatible clients.
Unlock the full potential of iMCP through LangDB's AI Gateway. Get enterprise-grade security, analytics, and seamless integration with zero configuration.
Free tier available • No credit card required
Discover shared experiences
iMCP is a macOS app for connecting your digital life with AI. It works with Claude Desktop and a growing list of clients that support the Model Context Protocol (MCP).
Calendar
View and manage calendar events, including creating new events with customizable settings like recurrence, alarms, and availability status.
Contacts
Access contact information about yourself and search your contacts by name, phone number, or email address.
Location
Access current location data and convert between addresses and geographic coordinates.
Maps
Provides location services including place search, directions, points of interest lookup, travel time estimation, and static map image generation.
Messages
Access message history with specific participants within customizable date ranges.
Reminders
View and create reminders with customizable due dates, priorities, and alerts across different reminder lists.
Weather
Access current weather conditions including temperature, wind speed, and weather conditions for any location.
[!TIP] Have a suggestion for a new capability? Reach out to us at
First, download the iMCP app (requires macOS 15.3 or later).
When you open the app, you'll see a
icon in your menu bar.
Clicking on this icon reveals the iMCP menu, which displays all available services. Initially, all services will appear in gray, indicating they're inactive.
The blue toggle switch at the top indicates that the MCP server is running and ready to connect with MCP-compatible clients.
To activate a service, click on its icon.
The system will prompt you with a permission dialog.
For example, when activating Calendar access, you'll see a dialog asking "iMCP" Would Like Full Access to Your Calendar.
Click Allow Full Access to continue.
[!IMPORTANT] iMCP does not collect or store any of your data. Clients like Claude Desktop do send your data off device as part of tool calls.
Once activated, each service icons goes from gray to their distinctive colors — red for Calendar, green for Messages, blue for Location, and so on.
Repeat this process for all of the capabilities you'd like to enable. These permissions follow Apple's standard security model, giving you complete control over what information iMCP can access.
-->
-->
If you don't have Claude Desktop installed, you can download it here.
Open Claude Desktop and go to "Settings... (⌘,)".
Click on "Developer" in the sidebar of the Settings pane,
and then click on "Edit Config".
This will create a configuration file at
~/Library/Application Support/Claude/claude_desktop_config.json.
To connect iMCP to Claude Desktop, click > "Configure Claude Desktop".
This will add or update the MCP server configuration to use the
imcp-server executable bundled in the application.
Other MCP server configurations in the file will be preserved.
You can also configure Claude Desktop manually
Click
> "Copy server command to clipboard".
Then open claude_desktop_config.json in your editor
and enter the following:
{ "mcpServers" : { "iMCP" : { "command" : "{paste iMCP server command}" } } }
Quit and reopen the Claude Desktop app. You'll be prompted to approve the connection.
After approving the connection, you should now see 🔨12 in the bottom right corner of your chat box. Click on that to see a list of all the tools made available to Claude by iMCP.
Now you can ask Claude questions that require access to your personal data, such as:
Claude will use the appropriate tools to retrieve this information, providing you with accurate, personalized responses without requiring you to manually share this data during your conversation.
iMCP is a macOS app that bundles a command-line executable, imcp-server.
iMCP.app provides UI for configuring services and — most importantly —
a means of interacting with macOS system permissions,
so that it can access Contacts, Calendar, and other information.imcp-server provides an MCP server that
uses standard input/output for communication
(stdio transport).The app and CLI communicate with each other on the local network
using Bonjour for automatic discovery.
Both advertise a service with type "_mcp._tcp" and domain "local".
Requests from MCP clients are read by the CLI from stdin
and relayed to the app;
responses from the app are received by the CLI and written to stdout.
See StdioProxy
for implementation details.
For this project, we created mcp-swift-sdk: a Swift SDK for Model Context Protocol servers and clients. The app uses this package to handle proxied requests from MCP clients.
Apple doesn't provide public APIs for accessing your messages.
However, the Messages app on macOS stores data in a SQLite database located at
~/Library/Messages/chat.db.
iMCP runs in App Sandbox,
which limits its access to user data and system resources.
When you go to enable the Messages service,
you'll be prompted to open the chat.db file through the standard file picker.
When you do, macOS adds that file to the app's sandbox.
NSOpenPanel is magic like that.
But opening the iMessage database is just half the battle.
Over the past few years,
Apple has moved away from storing messages in plain text
and instead toward a proprietary typedstream format.
For this project, we created Madrid:
a Swift package for reading your iMessage database.
It includes a Swift implementation for decoding Apple's typedstream format,
adapted from Christopher Sardegna's imessage-exporter project
and blog post about reverse-engineering typedstream.
The tools provided by iMCP return results as
JSON-LD documents.
For example,
the fetchContacts tool uses the Contacts framework,
which represents people and organizations with the CNContact type.
Here's how an object of that type is encoded as JSON-LD:
{ "@context": "https://schema.org", "@type": "Organization", "name": "Loopwork Limited", "url": "https://loop.work" }
Schema.org provides standard vocabularies for people, postal addresses, events, and many other objects we want to represent. And JSON-LD is a convenient encoding format for humans, AI, and conventional software alike.
For this project, we created Ontology: a Swift package for working with structured data. It includes convenience initializers for types from Apple frameworks, such as those returned by iMCP tools.
To debug interactions between iMCP and clients, you can use the inspector tool (requires Node.js):
# Download and run inspector package on imcp-server
npx @modelcontextprotocol/inspector [paste-copied-command]
# Open inspector web app running locally
open http://127.0.0.1:6274
This tool lets you see all requests and responses between the client and the iMCP server, which is helpful for understanding how the protocol works.
typedstream format
used by the Messages app.This project is licensed under the Apache License, Version 2.0.
iMessage® is a registered trademark of Apple Inc.
This project is not affiliated with, endorsed, or sponsored by Apple Inc.
Shared threads will appear here, showcasing real-world applications and insights from the community. Check back soon for updates!
Provides 8-day global weather forecasts and current conditions with detailed hourly and daily data, ...
Enables AI assistants to access and interact with your Mealie recipe database via Model Context Prot...
Enables advanced web browsing, data extraction, form automation, and multistep web task handling via...
An MCP server implementation enabling interaction with the PokeAPI to fetch dynamic Pokémon data and...
Bridges Root Signals API with Model Context Protocol clients to enable AI assistants and agents to p...