Install ImmyBot in Claude Desktop
What you need first
- Claude Desktop, installed.
- Docker, which
gives the
dockercommand the server starts with. - Your own values for
YOUR_IMMYBOT_TENANT_ID,YOUR_IMMYBOT_CLIENT_ID,YOUR_IMMYBOT_CLIENT_SECRET,YOUR_IMMYBOT_INSTANCE_SUBDOMAIN.
Steps
- In Claude Desktop, open Settings › Developer and choose Edit Config. It opens
claude_desktop_config.json. - Add this block. If the file already has
mcpServers, add only the entry inside it.
{
"mcpServers": {
"immybot-mcp": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "IMMYBOT_TENANT_ID", "-e", "IMMYBOT_CLIENT_ID", "-e", "IMMYBOT_CLIENT_SECRET", "-e", "IMMYBOT_INSTANCE_SUBDOMAIN", "ghcr.io/wyre-technology/immybot-mcp:v1.2.11"],
"env": { "IMMYBOT_TENANT_ID": "YOUR_IMMYBOT_TENANT_ID", "IMMYBOT_CLIENT_ID": "YOUR_IMMYBOT_CLIENT_ID", "IMMYBOT_CLIENT_SECRET": "YOUR_IMMYBOT_CLIENT_SECRET", "IMMYBOT_INSTANCE_SUBDOMAIN": "YOUR_IMMYBOT_INSTANCE_SUBDOMAIN" }
}
}
} - Replace
YOUR_IMMYBOT_TENANT_ID,YOUR_IMMYBOT_CLIENT_ID,YOUR_IMMYBOT_CLIENT_SECRET,YOUR_IMMYBOT_INSTANCE_SUBDOMAINwith your own values. - Save the file, quit Claude Desktop completely and open it again.
Check it worked
Ask Claude Desktop: List the tools of immybot-mcp.
If it does not start
- Cannot connect to the Docker daemon
- Docker is not running. Start it, then restart Claude Desktop.
- The server starts, but its tools fail
- A
YOUR_…placeholder is still in the config, or its value is wrong. - Nothing changes after a restart
- The file is not valid JSON any more. Look for a missing comma where the block was added.