{
  "manifest_version": "0.3",
  "name": "mac-messages-mcp",
  "display_name": "Mac Messages MCP",
  "version": "0.9.2",
  "description": "Query, search, and send macOS Messages through a local MCP server.",
  "long_description": "Mac Messages MCP runs locally on macOS and provides Claude Desktop with tools for reading recent Messages, fuzzy-searching conversations, resolving contacts, sending iMessage/SMS messages, listing chats, checking permissions, and finding or fetching message attachments. It requires Full Disk Access for Claude Desktop or the terminal used to run it.",
  "author": {
    "name": "Carter Lasalle",
    "email": "carterlasalle@gmail.com"
  },
  "repository": {
    "type": "git",
    "url": "https://github.com/carterlasalle/mac_messages_mcp.git"
  },
  "homepage": "https://github.com/carterlasalle/mac_messages_mcp",
  "support": "https://github.com/carterlasalle/mac_messages_mcp/issues",
  "license": "MIT",
  "keywords": [
    "macos",
    "messages",
    "imessage",
    "mcp",
    "claude-desktop"
  ],
  "server": {
    "type": "python",
    "entry_point": "mac_messages_mcp/server.py",
    "mcp_config": {
      "command": "uv",
      "args": [
        "--directory",
        "${__dirname}",
        "run",
        "mac-messages-mcp"
      ]
    }
  },
  "tools": [
    {
      "name": "tool_get_recent_messages",
      "description": "Read-only recent Messages lookup with optional contact or group chat ID filtering. Requires Full Disk Access and returns a plain-text message summary."
    },
    {
      "name": "tool_send_message",
      "description": "Sends one outgoing iMessage or SMS/RCS through Messages using E.164 phone numbers or emails. Requires Messages automation permission and returns a plain-text success or error."
    },
    {
      "name": "tool_find_contact",
      "description": "Read-only AddressBook contact lookup by fuzzy name match. Requires Contacts permission and returns E.164 phone numbers for contact:N selection."
    },
    {
      "name": "tool_check_db_access",
      "description": "Read-only diagnostic for Messages database access and Full Disk Access permission errors."
    },
    {
      "name": "tool_check_contacts",
      "description": "Read-only contact availability check returning a count and sample AddressBook entries."
    },
    {
      "name": "tool_check_addressbook",
      "description": "Read-only diagnostic for AddressBook database access and Contacts permission errors."
    },
    {
      "name": "tool_get_chats",
      "description": "Read-only group chat listing that returns chat names and IDs for group message sends."
    },
    {
      "name": "tool_check_imessage_availability",
      "description": "Read-only iMessage capability check for a phone number or email; does not send a message."
    },
    {
      "name": "tool_fuzzy_search_messages",
      "description": "Read-only fuzzy message search with similarity scores across a configurable time window."
    },
    {
      "name": "tool_search_attachments",
      "description": "Read-only attachment metadata search by date range, contact, and MIME type; returns IDs for later fetch."
    },
    {
      "name": "tool_get_attachment",
      "description": "Read-only attachment fetch by database ID, returning inline images when small enough or a local path otherwise."
    }
  ],
  "compatibility": {
    "platforms": [
      "darwin"
    ],
    "runtimes": {
      "python": ">=3.10"
    }
  }
}