Local iMessage RAG MCP Server

iMessage RAG MCP Server from Anthropic MCP Hackathon (NYC)

Catalog onlyCatalog onlySTDIO

Overview

Local iMessage RAG MCP Server is a project developed during the Anthropic NYC MCP hackathon, designed to facilitate local iMessage communication using a custom server setup.

To use the server, follow the setup instructions provided in the README files located in the project folders. Note that the project may have bugs and is not actively maintained.

Localized iMessage communication setup - Custom server configuration - Developed during a hackathon for experimental purposes

Setting up a local iMessage server for private communication.
Experimenting with iMessage functionalities in a controlled environment.
Learning about server configurations and local messaging protocols.

Add to your AI client

Use these steps to connect Local iMessage RAG MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "imessage-mcp-willccbb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-imessage-mcp-willccbb"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "imessage-mcp-willccbb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-imessage-mcp-willccbb"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "imessage-mcp-willccbb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-imessage-mcp-willccbb"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "imessage-mcp-willccbb": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-imessage-mcp-willccbb"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "imessage-mcp-willccbb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-imessage-mcp-willccbb"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "imessage-mcp-willccbb": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-imessage-mcp-willccbb"
      ]
    }
  }
}

FAQ

Is the server stable?

The server is likely to be buggy as it was developed during a hackathon and is not actively maintained.

Are there detailed instructions available?

Yes, setup instructions can be found in the README files within the project folders.

Is this project open for contributions?

The author has indicated that they are not planning to actively maintain it, but contributions may be welcome.

Developer tools