Missive MCP Server

Model Context Protocol (MCP) server for accessing Missive conversations in Claude Desktop.

🎯 What This Provides

Conversation Management

• Get Conversations: Retrieve recent conversations from your Missive inbox
• Filtered Conversations: Get conversations by mailbox (inbox, assigned, closed, flagged, etc.)
• Conversation Details: Get detailed information about specific conversations
• Conversation Messages: Retrieve messages from any conversation
• Conversation Comments: Get comments and tasks from conversations

Task Management

• Create Tasks: Create standalone tasks or conversation subtasks
• Update Tasks: Modify task details, state, assignees, and due dates

Message Operations

• Message Details: Get full message content including attachments
• Search Messages: Find messages by email Message-ID
• Create Messages: Send messages through custom channels

Security & Integration

• Secure Authentication: Uses your personal Missive API token
• Claude Integration: Works seamlessly with Claude Desktop
• Local Execution: Runs entirely on your machine for privacy and security

📁 Project Structure

missive-mcp/
├── local-server/
│   ├── main.py            # MCP server implementation
│   ├── requirements.txt   # Python dependencies
│   └── install.sh         # Automated setup script
├── README.md              # This file
└── LICENSE                # MIT License

🚀 Quick Start

Option 1: Automated Setup (Recommended)

cd local-server
./install.sh

The script will:

• Create a virtual environment
• Install dependencies
• Show you the exact configuration for Claude Desktop

Option 2: Manual Setup

1. Create virtual environment:

   cd local-server
   python3 -m venv .venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate

2. Install dependencies:

   pip install -r requirements.txt

3. Get your Missive API token:

   • Go to Missive → Settings → API
   • Create a new API token
   • Copy the token (starts with missive_pat-...)

⚙️ Claude Desktop Configuration

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "missive": {
      "command": "/path/to/missive-mcp/local-server/.venv/bin/python",
      "args": ["/path/to/missive-mcp/local-server/main.py"],
      "env": {
        "MISSIVE_API_TOKEN": "YOUR_MISSIVE_API_TOKEN_HERE"
      }
    }
  }
}

Important:

• Replace /path/to/missive-mcp/ with the actual path to this project
• Replace YOUR_MISSIVE_API_TOKEN_HERE with your actual Missive API token
• On Windows, use .venv\Scripts\python.exe instead of .venv/bin/python

🧪 Testing

1. Restart Claude Desktop completely (quit and reopen)
2. Test the connection by asking Claude:
   • "Show me my recent email conversations"
   • "What's in my Missive inbox?"
   • "Get my latest conversations"

🔧 How It Works

• Local execution: Runs as a local process launched by Claude Desktop
• Stdio transport: Uses standard input/output for MCP communication
• Environment variables: API token passed securely via environment
• Direct API calls: Connects directly to Missive API from your machine

🔐 Security Features

• ✅ No hardcoded tokens: You provide your own API token
• ✅ Local processing: All data stays on your machine
• ✅ Environment variables: Secure token storage
• ✅ Direct API calls: No intermediary services
• ✅ Minimal permissions: Only reads conversations

🛠 Troubleshooting

Connection Errors

1. Check paths: Ensure the paths in your Claude config are correct
2. Verify token: Make sure your Missive API token is valid
3. Check permissions: Ensure main.py is executable (chmod +x main.py)
4. Python path: Verify the virtual environment Python path is correct

Common Issues

• "spawn ENOENT": Wrong Python path in Claude config
• "nodename nor servname provided": Network connectivity issue
• "Invalid API token": Check your Missive API token

Getting Help

1. Check the Claude Desktop logs for detailed error messages
2. Test your API token with curl:

   curl -H "Authorization: Bearer YOUR_TOKEN" \
        "https://public.missiveapp.com/v1/conversations?inbox=true&limit=5"

🧑‍💻 Development

Local Testing

cd local-server
source .venv/bin/activate
MISSIVE_API_TOKEN="your_token" python main.py

Adding Features

The server uses the FastMCP framework. To add new tools:

1. Add a new function decorated with @mcp.tool
2. Use the Missive API documentation: https://learn.missiveapp.com/api-documentation
3. Follow the existing pattern in main.py

📚 API Reference

This server implements the following MCP tools:

Conversation Tools

• get_conversations: Get recent conversations from your Missive inbox
• get_conversations_filtered: Get conversations with filtering (inbox, assigned, closed, flagged, etc.)
• get_conversation_details: Get detailed information about a specific conversation
• get_conversation_messages: Get messages from a specific conversation
• get_conversation_comments: Get comments from a specific conversation

Task Management Tools

• create_task: Create a new task (standalone or conversation subtask)
• update_task: Update an existing task (title, description, state, assignees, due date)

Message Tools

• get_message_details: Get full details of a specific message including body and attachments
• search_messages_by_email_id: Find messages by email Message-ID header
• create_custom_message: Create a message in a custom channel

User Management Tools

• get_users: List users in organizations with optional filtering and pagination

Example Usage with Claude

Ask Claude things like:

• "Show me my flagged conversations"
• "Get details for conversation ID abc123"
• "Create a task titled 'Follow up with client' assigned to team xyz"
• "Update task abc123 to mark it as completed"
• "Get the full content of message def456"
• "Search for messages with Message-ID example@domain.com"
• "Show me all users in my organization"
• "List users for organization abc123"

🤝 Contributing

Contributions welcome! This project demonstrates:

• FastMCP framework usage
• Secure API token handling
• Claude Desktop integration patterns
• Local MCP server best practices

📄 License

MIT License - see LICENSE file for details.

🔗 Related Projects

• FastMCP - The MCP framework used
• Missive API - Official API documentation
• Model Context Protocol - MCP specification