> ## Documentation Index
> Fetch the complete documentation index at: https://developers.mihu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI and MCP

> Connect Claude Code, Cursor, VS Code, Windsurf and Claude Desktop to your Mihu workspace in one command

The [Mihu MCP Server](/guides/mcp) lets AI clients manage your workspace in natural language. The CLI configures those clients with the workspace and token from `mihu login`, so you never edit a config file by hand.

## Set up a client

```bash theme={null}
mihu mcp setup claude-code    # runs `claude mcp add` for you
mihu mcp setup cursor         # writes ~/.cursor/mcp.json
mihu mcp setup vscode         # writes the user-level mcp.json
mihu mcp setup windsurf       # writes ~/.codeium/windsurf/mcp_config.json
mihu mcp setup claude         # Claude Desktop, through the mcp-remote bridge (needs Node.js)
```

Restart the client, or reload its MCP servers, and ask it something:

> List my Mihu agents and tell me which ones have a phone number bound.

The client calls tools such as `list_agents` and `list_agent_phone_numbers` on `https://mcp.mihu.ai/mcp`, which forwards them to your workspace with your token.

<Warning>
  The token is written into the client's configuration file in plain text. Remove it with `mihu mcp remove <client>` when you no longer need it, and revoke the token in your dashboard if the machine is shared.
</Warning>

## Narrow the tool set

The server exposes several hundred tools. Clients work better with fewer:

```bash theme={null}
mihu mcp setup cursor --tool-profile inbox        # conversations, contacts, replies
mihu mcp setup cursor --tool-profile campaigns    # campaigns, listings, pools
mihu mcp setup cursor --tools compact             # every tool, shorter descriptions
```

Available profiles: `inbox`, `appointments`, `agent-builder`, `campaigns`, `workspace`, `quality`.

## Check the connection

```bash theme={null}
mihu mcp status
# server   Mihu MCP Server 3.2.4
# url      https://mcp.mihu.ai/mcp
# tenant   abc
# tools    61
```

## Other clients

`mihu mcp url` prints everything a client could need: the server URL, the headers, a URL with the token embedded for clients that cannot send headers, and the OAuth client credentials.

```bash theme={null}
mihu mcp url
mihu mcp url -o json
```

## Remove

```bash theme={null}
mihu mcp remove cursor
mihu mcp remove claude-code
```