Connect Claude to Mutiro

Use Claude Desktop to send messages and interact with Mutiro

Prerequisites

Before starting, make sure you have:

Choose Your Mode

User Mode (Recommended)

Messages come from your personal account

  • Perfect for personal use
  • Access all your conversations
  • Recipients see messages from you

Agent Mode

Messages come from a bot account

  • For automated assistants
  • Requires creating an agent first
  • Recipients see messages from the bot

This guide uses User Mode. For Agent Mode, see the Advanced section below.

1

Login to Mutiro

Authenticate with your Mutiro account:

mutiro auth login

You'll receive a one-time password via email to verify your identity.

2

Find Your Config File

Locate Claude Desktop's configuration file based on your operating system:

~/Library/Application Support/Claude/claude_desktop_config.json
%APPDATA%\Claude\claude_desktop_config.json
~/.config/Claude/claude_desktop_config.json
3

Add Mutiro to Claude

Add this configuration to the file:

{ "mcpServers": { "mutiro": { "command": "/usr/local/bin/mutiro", "args": ["mcp", "--mode", "user"] } } }

Update the command path if Mutiro is installed elsewhere. Use which mutiro to find it.

4

Restart Claude Desktop

Close and reopen Claude Desktop to load the new configuration. Mutiro tools will now be available!

How to Use

Once configured, you can ask Claude to:

  • "Send a summary of this conversation to alice"
  • "Share this code snippet with the dev team"
  • "Send this analysis to bob for review"

Troubleshooting

Claude doesn't show Mutiro tools
  • Make sure you restarted Claude Desktop
  • Check the config file is valid JSON
  • Verify the mutiro binary path is correct
Authentication failed
  • Run mutiro auth login again
  • Check mutiro auth whoami to verify login
  • Ensure you're connected to the right server
User not found errors
  • Verify the username exists
  • Check you're using the correct API endpoint
  • Don't include @ in usernames

Advanced: Agent Mode

For automated bots and assistants, use agent mode with an API key:

{ "mcpServers": { "mutiro-bot": { "command": "/usr/local/bin/mutiro", "args": ["mcp", "--mode", "agent"], "env": { "MUTIRO_AGENT_USERNAME": "my_bot", "MUTIRO_API_KEY": "mut_key_xxxxx" } } } }

Need more help? Check the CLI documentation or contact us.