MCP Server
The Tuco MCP (Model Context Protocol) Server lets AI assistants manage your iMessage platform using natural language.Install
Configure Claude Desktop
Add this to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json):
Get your API key from the API Keys tab in the Tuco dashboard.
Configuration
The server is configured entirely through environment variables (or the matching CLI flags):
Equivalent flags:
npx tuco-mcp --api-key tuco_your_api_key --api-url https://app.tuco.ai
Your API key is tied to one workspace and one environment — the
TUCO_API_URL must match the environment the key was issued for.Available Tools
Example Prompts
Once connected, just talk to your AI assistant:- “Send an iMessage to +12125551234 saying Hey, wanted to follow up on our call”
- “Check if +19042956129 has iMessage enabled”
- “Show me all conversations that need a reply”
- “Draft and send a reply to the latest message from +15551234567”
- “How are my sending lines doing?”
- “Show me the last 5 unread replies”
- “Add a lead: John Doe, +15551234567, CEO at Acme Corp”
Supported Clients
- Claude Desktop
- Cursor
- Windsurf
- Any MCP-compatible AI client