Extend Zo

MCP server

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

Use the Zo MCP Server to power up any AI that supports MCP with Zo's tools and context. Zo exposes an MCP (Model Context Protocol) endpoint, so AI tools like Claude Code, Gemini CLI, 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#

Go to Settings > Advanced and create an access token
Copy it immediately - you won't see it again
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 is Anthropic's CLI tool for Claude.

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:

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

Claude Desktop

Claude Desktop is Anthropic's desktop app for Claude.

Add to your claude_desktop_config.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 is an AI-powered code editor.

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

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

Zed

Zed is a high-performance code editor.

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

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

OpenCode

OpenCode is an open-source AI coding agent for the terminal.

Add to your opencode.json:

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

Gemini CLI

Gemini CLI is Google's command-line tool for Gemini.

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:

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

Codex

Codex is OpenAI's CLI tool.

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:

[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 as a bridge. Configure your client to run this command:

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:

{
  "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 are exposed via MCP with identical capabilities:

File Operations

Read, write, edit files on your Zo computer

Bash Commands

Execute shell commands

Web Browsing

Search the web, read pages, take screenshots

Image Generation

Generate and edit images with AI