iMCP MCP Server Integration

What does “iMCP” MCP Server do?

The iMCP (Intelligent Model Context Protocol) Server is a macOS application that acts as a bridge between AI assistants and key components of your digital life on Mac. By implementing the Model Context Protocol (MCP), iMCP allows AI clients like Claude Desktop to securely access and interact with your Messages, Contacts, Reminders, Calendar, Location, Weather, and more. This enables advanced development workflows, such as querying your calendar for upcoming events, managing reminders, searching contacts, or sending messages—all via AI-driven prompts and workflows. With standard macOS permissions and privacy protections, iMCP empowers users and developers to automate and enhance daily productivity by exposing powerful, context-rich tools to AI assistants in a privacy-conscious manner.

List of Prompts

No prompt templates are mentioned in the repository or documentation.

List of Resources

• Calendar
  Allows clients to view and manage calendar events, including creating new events and customizing recurrence, alarms, and availability status.
• Contacts
  Provides access to contact information and enables searching by name, phone number, or email.
• Location
  Offers access to current location data and supports conversion between addresses and geographic coordinates.
• Messages
  Enables access to message history with specific participants within customizable date ranges.
• Reminders
  Lets clients view and create reminders with customizable due dates, priorities, and alerts.
• Weather
  Supplies current weather conditions, including temperature, wind speed, and other data for any location.
• Maps
  Provides map-related services, including place search, directions, points of interest lookup, travel time estimation, and static map image generation.

List of Tools

No explicit tool function names or endpoints are listed in the repository files or documentation.

Use Cases of this MCP Server

• Calendar Management
  Automate scheduling, view upcoming events, and create new calendar entries directly from your AI assistant.
• Contact Lookup
  Instantly retrieve and use contact information, making it easy to search for people by name, number, or email.
• Location Services
  Get your current location, convert addresses to geographic coordinates, or find places of interest for navigation and context-aware tasks.
• Messaging Automation
  Access your message history and potentially automate sending messages or retrieving conversations.
• Reminders and Task Management
  Manage your reminders list, create new tasks, and set alerts or due dates—all from within an AI workflow.

How to set it up

Windsurf

1. Prerequisites: Ensure Windsurf is installed and up to date.
2. Locate Config: Find the Windsurf configuration file (typically ~/.windsurf/config.json).
3. Add iMCP Server: Insert the iMCP MCP server using a JSON snippet under the mcpServers object.
4. Save/Restart: Save the config and restart Windsurf.
5. Verify: Confirm iMCP appears as a connected MCP server.

Example configuration:

{
  "mcpServers": {
    "imcp": {
      "command": "imcp",
      "args": []
    }
  }
}

Claude

1. Prerequisites: Install Claude Desktop from claude.ai/download.
2. Locate Config: Open Claude Desktop, go to Settings → Developer → Edit Config. This creates or opens ~/Library/Application Support/Claude/claude_desktop_config.json.
3. Add iMCP Server: Add iMCP to the mcpServers section.
4. Save/Restart: Save the config and restart Claude Desktop.
5. Verify: Check that iMCP is available as a tool.

Example configuration:

{
  "mcpServers": {
    "imcp": {
      "command": "imcp",
      "args": []
    }
  }
}

Cursor

1. Prerequisites: Make sure Cursor is installed.
2. Locate Config: Find Cursor’s MCP config file.
3. Add iMCP Server: Add the iMCP server to the mcpServers object.
4. Save/Restart: Save changes and restart Cursor.
5. Verify: Ensure iMCP is recognized.

Example configuration:

{
  "mcpServers": {
    "imcp": {
      "command": "imcp",
      "args": []
    }
  }
}

Cline

1. Prerequisites: Install Cline and dependencies.
2. Locate Config: Open or create the Cline MCP config file.
3. Add iMCP Server: Add iMCP under the mcpServers key.
4. Save/Restart: Save the file and restart Cline.
5. Verify: Confirm iMCP is active within Cline.

Example configuration:

{
  "mcpServers": {
    "imcp": {
      "command": "imcp",
      "args": []
    }
  }
}

Securing API Keys Example

For enhanced security, store API keys as environment variables and reference them in your configuration:

{
  "mcpServers": {
    "imcp": {
      "command": "imcp",
      "args": [],
      "env": {
        "API_KEY": "${IMCP_API_KEY}"
      },
      "inputs": {
        "apiKey": "${IMCP_API_KEY}"
      }
    }
  }
}

Replace IMCP_API_KEY with your actual environment variable name.

How to use this MCP inside flows

Using MCP in FlowHunt

To integrate MCP servers into your FlowHunt workflow, start by adding the MCP component to your flow and connecting it to your AI agent:

Click on the MCP component to open the configuration panel. In the system MCP configuration section, insert your MCP server details using this JSON format:

{
  "imcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Once configured, the AI agent is now able to use this MCP as a tool with access to all its functions and capabilities. Remember to change “imcp” to whatever the actual name of your MCP server is and replace the URL with your own MCP server URL.

Overview

Based on the above, iMCP provides robust resource integration for macOS users but lacks explicit documentation about prompt templates, tool function names, or sampling/roots support. The setup process is straightforward and well-documented.

Our opinion

iMCP is a strong, privacy-conscious MCP server tailored for macOS, offering deep integration with native apps and a simple setup process for major AI clients. It scores high for usability and resource exposure but would benefit from clearer documentation on tools, prompt templates, and sampling support.

MCP Score