{
  "markdown": "Check it out on https://mcp.paperknife.app/\n\n# WhatsApp MCP for macOS\n\n<!-- mcp-name: io.github.kalki-kgp/whatsapp-macos -->\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server that connects Claude to your WhatsApp. Ask Claude to catch you up on unread chats, search your message history, or send a reply.\n\nReading works in about a minute with no QR scan and no Node.js. Sending is optional and needs one extra step.\n\n<p align=\"center\">\n  <img src=\"https://img.shields.io/badge/platform-macOS-blue\" alt=\"macOS\">\n  <img src=\"https://img.shields.io/badge/MCP-1.0-green\" alt=\"MCP 1.0\">\n  <img src=\"https://img.shields.io/badge/license-MIT-lightgrey\" alt=\"MIT License\">\n</p>\n\n## Features\n\nSearch contacts by name or phone number. Read chat history with date filtering. List recent conversations with unread counts. Summarize everything you haven't read yet. Send replies and receive incoming messages once the bridge is connected.\n\n## Requirements\n\n- macOS with the WhatsApp desktop app installed and logged in\n- Node.js 18+, only if you want to send messages\n\nYou don't need to install Python. `uvx` fetches a suitable version on its own.\n\n## Installation\n\nInstall [uv](https://docs.astral.sh/uv/) if you don't have it:\n\n```bash\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\nThat's the whole install. `uvx` downloads the server on first launch, so there's no virtualenv to create and no `pip install` step. Go to the next section to point Claude at it.\n\n### From source\n\n```bash\ngit clone https://github.com/kalki-kgp/whatsapp-mcp.git\ncd whatsapp-mcp\nuv venv && uv pip install -e .\n```\n\n## Connect to Claude Desktop\n\n1. Open config file:\n   ```bash\n   open ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n   ```\n   If it doesn't exist, create it.\n\n2. Find the full path to `uvx`:\n   ```bash\n   which uvx\n   ```\n\n3. Add the WhatsApp MCP server, pasting that path as the command:\n   ```json\n   {\n     \"mcpServers\": {\n       \"whatsapp\": {\n         \"command\": \"/Users/YOU/.local/bin/uvx\",\n         \"args\": [\"whatsapp-mcp-macos\"]\n       }\n     }\n   }\n   ```\n\n   Use the absolute path, not bare `uvx`. Claude Desktop starts with a minimal PATH that doesn't include `~/.local/bin`, so a bare command name is the most common reason the server never appears.\n\n4. Restart Claude Desktop with Cmd+Q, then reopen. Closing the window is not enough.\n\n5. Click the MCP tools icon in the chat input and check that \"whatsapp\" is listed.\n\n6. Start chatting:\n   - \"Show my recent WhatsApp chats\"\n   - \"Search messages for dinner plans\"\n\n## Connect to Cursor\n\nAdd to `.cursor/mcp.json` in your project:\n\n```json\n{\n  \"mcpServers\": {\n    \"whatsapp\": {\n      \"command\": \"/Users/YOU/.local/bin/uvx\",\n      \"args\": [\"whatsapp-mcp-macos\"]\n    }\n  }\n}\n```\n\nRestart Cursor and use WhatsApp tools in the AI chat.\n\n## Usage\n\n### Reading messages (works immediately)\n\nJust ask Claude:\n- \"Show my recent WhatsApp chats\"\n- \"Search for messages about dinner\"\n- \"What did John say yesterday?\"\n- \"Catch me up on unread messages\"\n\n### Sending messages (requires bridge)\n\n1. Start the WhatsApp bridge:\n   ```bash\n   cd bridge && npm install && npm start\n   ```\n\n2. Ask Claude to check connection:\n   - \"Check WhatsApp status\"\n   \n3. If it shows a QR code, open the data URL in a browser and scan with your phone\n\n4. Once connected, you can send:\n   - \"Send a message to Mom saying I'll be late\"\n   - \"Reply to John with 'sounds good'\"\n\n## Tools\n\n| Tool | Description | Requires Bridge |\n|------|-------------|-----------------|\n| `whatsapp_status` | Check connection, get QR if needed | No |\n| `whatsapp_search_contacts` | Search contacts by name/phone | No |\n| `whatsapp_list_chats` | List recent conversations | No |\n| `whatsapp_get_messages` | Get messages from a chat | No |\n| `whatsapp_search_messages` | Search across all chats | No |\n| `whatsapp_unread` | Get unread message summary | No |\n| `whatsapp_send` | Send a message | Yes |\n| `whatsapp_incoming` | Get real-time incoming messages | Yes |\n\n## How it works\n\n```\nClaude ──MCP──▶ WhatsApp MCP Server\n                       │\n                       ├──▶ Local SQLite DBs (read messages)\n                       │    ~/Library/Group Containers/group.net.whatsapp.WhatsApp.shared/\n                       │\n                       └──▶ WhatsApp Bridge (:3010) ──▶ WhatsApp Web\n                            (for sending)\n```\n\nRead operations query the local WhatsApp database directly, so they work offline and need no bridge.\n\n**Send operations** go through the bridge, which connects to WhatsApp Web using [Baileys](https://github.com/WhiskeySockets/Baileys).\n\n## Development\n\n```bash\n# Clone\ngit clone https://github.com/kalki-kgp/whatsapp-mcp.git\ncd whatsapp-mcp\n\n# Install in dev mode\npip install -e \".[dev]\"\n\n# Run server\npython -m whatsapp_mcp\n```\n\n## Privacy\n\n- All data stays local. The server reads messages from your own WhatsApp database\n- No data is sent to external servers (except WhatsApp Web when sending)\n- The MCP server runs locally on your machine\n\n## License\n\nMIT\n",
  "bytes": 5039,
  "sha": "eb3d168ad393aeb9c8c1211bb64d1d3dc615d31d2cf107519d5b0ac01be5e615",
  "repo_slug": "kalki-kgp/whatsapp-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kalki_kgp_whatsapp_macos_7151b734/readme"
}