Claude Desktop Configuration

This guide walks you through configuring Claude Desktop to connect with your MoMail data via MCP.

Prerequisites

• Claude Desktop installed (version 1.0.0 or later)
• A MoMail account with an API key
• Your API key (starts with mk_)

Step 1: Locate Configuration File

Claude Desktop stores its MCP configuration in a JSON file. The location depends on your operating system:

OS	Config Path
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%/Claude/claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

Step 2: Edit Configuration

Add MoMail to your MCP servers configuration using StreamableHTTP transport:

{
  "mcpServers": {
    "momail": {
      "transport": "streamableHttp",
      "url": "https://momail.io/v1/mcp",
      "headers": {
        "Authorization": "Bearer your_api_key"
      }
    }
  }
}

Complete Example Configuration

{
  "mcpServers": {
    "momail": {
      "transport": "streamableHttp",
      "url": "https://momail.io/v1/mcp",
      "headers": {
        "Authorization": "Bearer mk_a1b2c3d4_e5f6g7h8i9j0k1l2m3n4o5p6"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/files"]
    }
  }
}

Step 3: Restart Claude Desktop

After saving the configuration file:

1. Quit Claude Desktop completely
2. Restart the application
3. Look for the MoMail tools in the tool picker (hammer icon)

Step 4: Verify Connection

Start a new conversation and ask Claude:

“List my mailboxes”

If configured correctly, Claude will:

1. Show a tool use indicator
2. Call the list_mailboxes tool
3. Display your mailboxes

Troubleshooting

”Transport not supported” Error

Make sure Claude Desktop is updated to version 1.0.0 or later. StreamableHTTP support was added in this version.

”Unauthorized” Error

• Verify your API key is correct
• Ensure the key is active in your MoMail dashboard
• Use the header name Authorization with value Bearer mk_… (include the Bearer prefix)

Tools Not Appearing

• Check the Claude Desktop logs for errors
• Verify the JSON syntax in your config file
• Ensure the URL is correct: https://momail.io/v1/mcp

Connection Timeout

• Check your internet connection
• Verify https://momail.io/v1/mcp is accessible
• Try restarting Claude Desktop

Advanced Configuration

Using Environment Variables

For better security, you can use environment variables in your configuration:

{
  "mcpServers": {
    "momail": {
      "transport": "streamableHttp",
      "url": "https://momail.io/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${MOMAIL_API_KEY}"
      }
    }
  }
}

Set the environment variable before starting Claude Desktop:

export MOMAIL_API_KEY=mk_a1b2c3d4_e5f6g7h8i9j0k1l2m3n4o5p6

Multiple MoMail Accounts

You can configure multiple MoMail accounts by using different server names:

{
  "mcpServers": {
    "momail-personal": {
      "transport": "streamableHttp",
      "url": "https://momail.io/v1/mcp",
      "headers": {
        "Authorization": "Bearer your_personal_api_key"
      }
    },
    "momail-work": {
      "transport": "streamableHttp",
      "url": "https://momail.io/v1/mcp",
      "headers": {
        "Authorization": "Bearer your_work_api_key"
      }
    }
  }
}

Configuration Reference

Field	Required	Description
transport	Yes	Must be streamableHttp
url	Yes	MCP endpoint URL
headers.Authorization	Yes	Bearer mk_… (your MoMail API key)

Next Steps

Now that Claude Desktop is configured:

Explore Tools Learn what you can do with MoMail MCP

See Examples Get inspiration from example conversations