# MCP server

Power up any MCP-compatible AI with Zo's tools and context

Use the [Zo MCP Server](/guide/mcp-server) to power up any AI that supports MCP with Zo's tools and context. Zo exposes an [MCP (Model Context Protocol)](https://modelcontextprotocol.io) endpoint, so AI tools like [Claude Code](https://claude.ai/code), [Gemini CLI](https://github.com/google-gemini/gemini-cli), [Codex](https://github.com/openai/codex), or any other MCP-compatible tool can access your Zo directly — your files, your connected apps like Gmail and Google Calendar, and all of Zo's tools.

## Why use Zo as an MCP server?

Zo is a full Linux server in the cloud with 50+ tools built in:

- **Files & shell** — read, write, search, run commands
- **Integrations** — Gmail, Calendar, Notion, Linear, Airtable, Dropbox, Spotify
- **Capabilities** — web browsing, image generation, scheduled tasks, texting, emailing
- **Fully yours** — root access, persistent storage, install anything you want

## Quick start

1. Go to **Settings > Advanced** and create an access token
2. Copy it immediately - you won't see it again
3. Configure your AI tool using the instructions below

> **Warning**
>
> Your API key grants full access to your Zo. Keep it secret and never commit it
> to version control.

## Configuration

**Claude Code**

[Claude Code](https://docs.anthropic.com/en/docs/claude-code) is Anthropic's CLI tool for Claude.

```bash
claude mcp add --transport http zo https://api.zo.computer/mcp \
  --header "Authorization: Bearer zo_sk_your_key_here"
```

Or add it manually to `~/.claude/settings.json`:

```json
{
  "mcpServers": {
    "zo": {
      "type": "http",
      "url": "https://api.zo.computer/mcp",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}
```

**Claude Desktop**

[Claude Desktop](https://claude.ai/download) is Anthropic's desktop app for Claude.

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "zo": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://api.zo.computer/mcp",
        "--header",
        "Authorization: Bearer zo_sk_your_key_here"
      ]
    }
  }
}
```

Config file location: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows).

**Cursor**

[Cursor](https://cursor.com) is an AI-powered code editor.

Add to your Cursor MCP settings (`~/.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "zo": {
      "url": "https://api.zo.computer/mcp",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}
```

**Zed**

[Zed](https://zed.dev) is a high-performance code editor.

Add to your Zed settings (`~/.config/zed/settings.json`):

```json
{
  "context_servers": {
    "zo": {
      "settings": {},
      "url": "https://api.zo.computer/mcp",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}
```

**OpenCode**

[OpenCode](https://opencode.ai) is an open-source AI coding agent for the terminal.

Add to your `opencode.json`:

```json
{
  "mcp": {
    "zo": {
      "type": "remote",
      "url": "https://api.zo.computer/mcp",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}
```

**Gemini CLI**

[Gemini CLI](https://geminicli.com/) is Google's command-line tool for Gemini.

```bash
gemini mcp add zo https://api.zo.computer/mcp --transport http --scope user \
  -H "Authorization: Bearer zo_sk_your_key_here"
```

Or add it manually to `~/.gemini/settings.json`:

```json
{
  "mcpServers": {
    "zo": {
      "url": "https://api.zo.computer/mcp",
      "type": "http",
      "headers": {
        "Authorization": "Bearer zo_sk_your_key_here"
      }
    }
  }
}
```

**Codex**

[Codex](https://github.com/openai/codex) is OpenAI's CLI tool.

```bash
codex mcp add zo -- npx -y mcp-remote https://api.zo.computer/mcp \
  --header "Authorization:Bearer zo_sk_your_key_here" --transport http-only
```

Or add it manually to `~/.codex/config.toml`:

```toml
[mcp_servers.zo]
command = "npx"
args = ["-y", "mcp-remote", "https://api.zo.computer/mcp", "--header", "Authorization:Bearer zo_sk_your_key_here", "--transport", "http-only"]
```

**Other MCP clients**

Zo's MCP endpoint uses standard HTTP transport. For any MCP-compatible client, use:

| Setting     | Value                                       |
| ----------- | ------------------------------------------- |
| Transport   | HTTP                                        |
| URL         | `https://api.zo.computer/mcp`               |
| Auth Header | `Authorization: Bearer zo_sk_your_key_here` |

If your client only supports stdio transport (not HTTP), you can use [mcp-remote](https://www.npmjs.com/package/mcp-remote) as a bridge. Configure your client to run this command:

```bash
npx -y mcp-remote https://api.zo.computer/mcp --header "Authorization:Bearer zo_sk_your_key_here" --transport http-only
```

For example, in a JSON config that expects `command` and `args`:

```json
{
  "command": "npx",
  "args": ["-y", "mcp-remote", "https://api.zo.computer/mcp", "--header", "Authorization:Bearer zo_sk_your_key_here", "--transport", "http-only"]
}
```

## Available tools

All [Zo tools](/guide/tools) are exposed via MCP with identical capabilities:

[**File Operations**](/reference/tools/read-file)

Read, write, edit files on your Zo computer

[**Bash Commands**](/reference/tools/bash)

Execute shell commands

[**Web Browsing**](/reference/tools/read-webpage)

Search the web, read pages, take screenshots

[**Image Generation**](/reference/tools/generate-image)

Generate and edit images with AI