iMCP

iMCP

Installable
mattt
GitHub

About

A macOS app that provides an MCP server to access your Messages, Contacts, Reminders, Calendar, Location, Maps, and Weather. Works with Claude Desktop and other MCP-compatible clients.

Capabilities

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.

Installation

Download the iMCP app from iMCP.app/download (requires macOS 15.3 or later), or install via Homebrew:

brew install --cask mattt/tap/iMCP

Setup

  1. Open the app - you'll see a menu bar icon
  2. Click each service icon to activate it and grant the required macOS permissions
  3. Connect to your MCP client (Claude Desktop, Claude Code, Cursor, or Amp)

For Claude Desktop: Click the menu bar icon > "Configure Claude Desktop" to automatically add the configuration.

Technical Details

iMCP is a macOS app that bundles a command-line executable (imcp-server) which uses stdio transport. The app and CLI communicate via Bonjour for automatic discovery on the local network. Tool results are returned as JSON-LD documents using Schema.org vocabularies.

The Messages capability accesses the iMessage database (~/Library/Messages/chat.db) and includes a Swift implementation for decoding Apple's proprietary typedstream format.

Important Notes

  • iMCP does not collect or store any of your data
  • Requires macOS 15.3 or later
  • Uses App Sandbox for security
  • When a client first connects, you'll need to approve the connection

This server runs through your single 1Server connection. No extra config required.

0Installs
--Stars

Categories

ProductivityCommunication