Skip to main content
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

  1. Go to Settings > Developers and create an API key
  2. Copy it immediately - you won’t see it again
  3. Configure your AI tool using the instructions below
Your API key grants full access to your Zo. Keep it secret and never commit it to version control.

​
Configuration

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 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 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 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 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 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 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"]
Zo’s MCP endpoint uses standard HTTP transport. For any MCP-compatible client, use:
SettingValue
TransportHTTP
URLhttps://api.zo.computer/mcp
Auth HeaderAuthorization: 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

Integrations

Gmail, Notion, Linear, Google Calendar, and more

Image Generation

Generate and edit images with AI