iMCP

v1.0.0Developer Toolsstable

A universal bridge that turns legacy backend services and modern APIs into AI-accessible tools without requiring code rewrites. It dynamically generates tool definitions from WSDL, OpenAPI, or custom JSON specs to enable AI assistants to interact wit

macosmcp
Share:
1,429
Stars
0
Downloads
0
Weekly
0/5

What is iMCP?

iMCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to universal bridge that turns legacy backend services and modern apis into ai-accessible tools without requiring code rewrites. it dynamically generates tool definitions from wsdl, openapi, or custom js...

A universal bridge that turns legacy backend services and modern APIs into AI-accessible tools without requiring code rewrites. It dynamically generates tool definitions from WSDL, OpenAPI, or custom JSON specs to enable AI assistants to interact wit

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A universal bridge that turns legacy backend services and mo

Use Cases

Convert legacy WSDL/OpenAPI services to AI tools
Bridge between backend systems and AI assistants
mattt

Maintainer

LicenseMIT License
Languageswift
Versionv1.0.0
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx imcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use iMCP

iMCP is a native macOS menu bar app that turns your Mac's built-in Apple services—Calendar, Contacts, Messages, Reminders, Maps, Location, and Weather—into MCP tools that any AI assistant can call. It requires no code, no API keys, and no cloud services; it simply grants the AI structured access to data already on your device using macOS permission dialogs. Users install it once, enable the services they want, and their AI assistant can immediately answer questions like 'What meetings do I have tomorrow?' or 'Find John's phone number' using real local data.

Prerequisites

  • macOS 15.3 (Sequoia) or later
  • iMCP app downloaded from iMCP.app or installed via Homebrew
  • Claude Desktop, Claude Code, Cursor, or Amp as your MCP client
  • macOS system permissions granted for each service you enable (Calendar, Contacts, etc.)
1

Install iMCP

Download iMCP from the official site or install via Homebrew. The app places a menu bar icon in your macOS status bar.

brew install --cask mattt/tap/iMCP
# Or download directly from: https://imcp.app/download
2

Enable desired services

Click the iMCP menu bar icon and click each service you want to activate (Calendar, Contacts, Location, Maps, Messages, Reminders, Weather). Grant macOS permission prompts as they appear. Active services show colored icons instead of gray ones.

3

Connect to Claude Code

Add iMCP as a user-scoped MCP server in Claude Code using the absolute path to the installed CLI binary.

claude mcp add --scope user iMCP -- /Applications/iMCP.app/Contents/MacOS/imcp-server
4

Connect to Claude Desktop

In Claude Desktop, go to Settings > Developer > Edit Config. Then in the iMCP menu bar app, click 'Configure Claude Desktop' to auto-populate the configuration.

{
  "mcpServers": {
    "iMCP": {
      "command": "/Applications/iMCP.app/Contents/MacOS/imcp-server"
    }
  }
}
5

Connect to Amp

Add iMCP to Amp using its CLI command.

amp mcp add iMCP -- /Applications/iMCP.app/Contents/MacOS/imcp-server
6

Verify the connection

Ask your AI assistant a question that requires one of the enabled services, such as checking your calendar. The assistant should return real data from your device.

iMCP Examples

Client configuration

Claude Desktop configuration connecting to the iMCP server binary on macOS.

{
  "mcpServers": {
    "iMCP": {
      "command": "/Applications/iMCP.app/Contents/MacOS/imcp-server"
    }
  }
}

Prompts to try

Once iMCP is connected and services are enabled, try these natural language queries.

- "What meetings do I have tomorrow?"
- "Find John Smith's phone number in my Contacts"
- "What's the weather like where I am right now?"
- "Show me my reminders due this week"
- "How long does it take to drive from my current location to SFO?"
- "Read my last 5 messages from my sister"
- "Create a reminder to call the dentist on Friday at 10am"

Troubleshooting iMCP

A service icon stays gray and the tool returns no data

Click the service icon in the iMCP menu bar to activate it, then grant the macOS permission prompt. If no prompt appears, go to System Settings > Privacy & Security and manually enable access for iMCP for the relevant category (Calendar, Contacts, etc.).

Messages tool cannot read message history

Messages require SQLite database access. When prompted, use the macOS file picker to grant iMCP access to ~/Library/Messages/chat.db. This is required due to macOS sandbox restrictions and cannot be automated.

imcp-server binary not found at /Applications/iMCP.app/Contents/MacOS/imcp-server

Verify iMCP is installed in /Applications (not ~/Applications). If using Homebrew, check the installed path with `brew info --cask mattt/tap/iMCP`. Update the path in your MCP client config accordingly.

Frequently Asked Questions about iMCP

What is iMCP?

iMCP is a Model Context Protocol (MCP) server that universal bridge that turns legacy backend services and modern apis into ai-accessible tools without requiring code rewrites. it dynamically generates tool definitions from wsdl, openapi, or custom json specs to enable ai assistants to interact wit It connects AI assistants to external tools and data sources through a standardized interface.

How do I install iMCP?

Follow the installation instructions on the iMCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with iMCP?

iMCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is iMCP free to use?

Yes, iMCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "imcp": { "command": "npx", "args": ["-y", "imcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use iMCP?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides