MCP Clients - Context7 MCP
Skip to main content
Context7 supports all MCP clients. Below are configuration examples for popular clients. If your client isn’t listed, check its documentation for MCP server installation. To configure manually, use the Context7 server URL https://mcp.context7.com/mcp with your MCP client and pass your API key via the CONTEXT7_API_KEY header.
Looking for the easiest way to get started? Use npx ctx7 setup to configure Context7 automatically, and npx ctx7 remove to remove the generated setup later. See the CLI docs for more details.
For detailed guides including rules, skills, agents, and best practices, see Cursor for rules and Composer integration tips, and Claude Code for skills, agents, commands, and plugin installation.

OAuth Authentication

Context7 MCP server supports OAuth 2.0 authentication for MCP clients that implement the MCP OAuth specification. To use OAuth, change the endpoint from /mcp to /mcp/oauth in your client configuration:
- "url": "https://mcp.context7.com/mcp"
+ "url": "https://mcp.context7.com/mcp/oauth"
OAuth is only available for remote HTTP connections. For local MCP connections using stdio transport, use API key authentication instead.
Run this command. See Claude Code MCP docs for more info.

Local Server Connection

claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

Remote Server Connection

claude mcp add --scope user --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcp
Go to: Cursor Settings -> Tools & MCP -> New MCP ServerPasting the following configuration into your Cursor ~/.cursor/mcp.json file is the recommended approach. You may also install in a specific project by creating .cursor/mcp.json in your project folder. See Cursor MCP docs for more info.Since Cursor 1.0, you can click the install button below for instant one-click installation.

Remote Server Connection

Install MCP Server
{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server Connection

Install MCP Server
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
Add this to your Opencode configuration file. See Opencode MCP docs for more info.

Remote Server Connection

"mcp": {
  "context7": {
    "type": "remote",
    "url": "https://mcp.context7.com/mcp",
    "headers": {
      "CONTEXT7_API_KEY": "YOUR_API_KEY"
    },
    "enabled": true
  }
}

Local Server Connection

{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
      "enabled": true
    }
  }
}
See OpenAI Codex MCP docs for more info.

Context7 Plugin

You can also install Context7 as a Codex plugin. It connects to the hosted MCP server and includes a documentation lookup skill. After installation, a browser window opens so you can log in via OAuth.
codex plugin marketplace add upstash/context7
codex plugin add context7@context7-marketplace
Start a new Codex thread after installation so Codex can load the plugin.

Using CLI

codex mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

Local Server Connection

Add this to your Codex configuration file (~/.codex/config.toml or .codex/config.toml).
[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
startup_timeout_ms = 20_000

Remote Server Connection

[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"
http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }
If you see startup timeout errors, try increasing startup_timeout_ms to 40_000.
Add this to your Antigravity MCP config file. See Antigravity MCP docs for more info.

Remote Server Connection

{
  "mcpServers": {
    "context7": {
      "serverUrl": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server Connection

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
The easiest way to install is the Context7 VS Code extension, which registers the server automatically and supports an API key via the context7.apiKey setting. See VS Code for details. For manual configuration, use the options below. Install in VS Code (npx) Install in VS Code Insiders (npx)Add this to your VS Code MCP config file (.vscode/mcp.json). See VS Code MCP docs for more info.

Remote Server Connection

{
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server Connection

{
  "servers": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
See Kiro Model Context Protocol Documentation for details.Add to Kiro
  1. Navigate Kiro > MCP Servers
  2. Add a new MCP server by clicking the + Add button.
  3. Paste the configuration:

Remote Server Connection

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}
To use an API key in Kiro, add:
"headers": {
  "CONTEXT7_API_KEY": "YOUR_API_KEY"
}
See the API keys guide for how to create one.

Local Server Connection

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
  1. Click Save to apply.
You can configure the Context7 MCP server in Kilo Code using either the UI or by editing your config file. See Kilo Code MCP docs for more info.Kilo Code stores MCP servers in a kilo.jsonc file:
  • Global~/.config/kilo/kilo.jsonc
  • Projectkilo.jsonc in your project root or .kilo/kilo.jsonc (takes precedence)

Configure via Kilo Code UI

  1. Click the Settings icon in the sidebar toolbar.
  2. Navigate to the Agent Behaviour tab.
  3. Select the MCP Servers sub-tab.
  4. Click Add Server and choose Remote (HTTP) or Local (stdio).
  5. Fill in the details and save.

Manual Configuration

Add Context7 under the mcp key in your kilo.jsonc.

Remote Server Connection

{
  "mcp": {
    "context7": {
      "type": "remote",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      },
      "enabled": true
    }
  }
}

Local Server Connection

{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
      "enabled": true
    }
  }
}
Add this to your Roo Code MCP configuration file. See Roo Code MCP docs for more info.

Remote Server Connection

{
  "mcpServers": {
    "context7": {
      "type": "streamable-http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server Connection

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
Add this to your Devin Desktop MCP config file. See Devin Desktop MCP docs for more info.

Remote Server Connection

{
  "mcpServers": {
    "context7": {
      "serverUrl": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server Connection

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Remote Server Connection

Open Claude Desktop and navigate to Settings > Connectors > Add Custom Connector. Enter the name as Context7 and the remote MCP server URL as https://mcp.context7.com/mcp.

Local Server Connection

Open Claude Desktop developer settings and edit your claude_desktop_config.json file. See Claude Desktop MCP docs for more info.
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
ChatGPT supports MCP servers through remote connectors via Developer Mode (beta). Available for Pro, Plus, Team, Enterprise, and Edu plans.

1. Enable Developer Mode

Go to: SettingsAppsAdvanced settings → Enable Developer Mode

2. Create an App

Go to: SettingsAppsCreate AppFill in the following:
Accept the security notice and complete the one-time OAuth authorization.

3. Use in a Conversation

Start a new chat → Click the plus icon → Hover over More → Select the Context7 app.Alternatively, you can say use context7 in your prompt and ChatGPT will automatically use the Context7 app.See OpenAI MCP docs for more info.
The ChatGPT desktop app shares apps configured on the web. Set up the app on chatgpt.com first.

1. Enable Developer Mode (on the Web)

Go to: SettingsAppsAdvanced settings → Enable Developer Mode

2. Create an App (on the Web)

Go to: SettingsAppsCreate AppFill in the following:
Accept the security notice and complete the one-time OAuth authorization.

3. Use in the Desktop App

Open the ChatGPT desktop app → Start a new chat → ChatGPT will automatically use the Context7 app when you ask it to.Apps configured on the web are automatically available in the desktop app.See OpenAI MCP docs for more info.
Use the Add manually feature and fill in the JSON configuration. See Trae documentation for more details.

Remote Server Connection

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server Connection

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
You can easily install Context7 through the Cline MCP Server Marketplace by following these instructions:
  1. Open Cline.
  2. Click the hamburger menu icon to enter the MCP Servers section.
  3. Use the search bar within the Marketplace tab to find Context7.
  4. Click the Install button.
Or you can directly edit MCP servers configuration:
  1. Open Cline.
  2. Click the hamburger menu icon to enter the MCP Servers section.
  3. Choose Remote Servers tab.
  4. Click the Edit Configuration button.
  5. Add context7 to mcpServers:
{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
To configure Context7 MCP in Augment Code, you can use either the graphical interface or manual configuration. See Augment Code MCP docs for more info.

Using the Augment Code UI

  1. Open the options menu in the upper right of the Augment panel.
  2. Select Settings.
  3. Navigate to the MCP section.
  4. Click the + button to add a new server.
  5. Enter the name Context7 and the command:
    npx -y @upstash/context7-mcp@latest
    

Manual Configuration

In the MCP section, use Import from JSON and paste the following (a top-level mcpServers object keyed by server name):
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
See Gemini CLI Configuration for details.
  1. Open the Gemini CLI settings file at ~/.gemini/settings.json
  2. Add the following to the mcpServers object:
{
  "mcpServers": {
    "context7": {
      "httpUrl": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}
Or, for a local server:
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
Use the Hermes CLI or edit ~/.hermes/config.yaml directly. See the Hermes CLI docs for more info.

Remote Server Connection (API Key)

Add this to your Hermes config file (~/.hermes/config.yaml).
mcp_servers:
  context7:
    url: "https://mcp.context7.com/mcp"
    headers:
      CONTEXT7_API_KEY: "YOUR_API_KEY"

Remote Server Connection (OAuth)

mcp_servers:
  context7:
    url: "https://mcp.context7.com/mcp/oauth"
    auth: oauth

Using CLI (OAuth)

hermes mcp add context7 --url https://mcp.context7.com/mcp/oauth --auth oauth

Local Server Connection

mcp_servers:
  context7:
    command: "npx"
    args: ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
Start with the API key method if you want the most direct setup. Hermes also supports OAuth for remote MCP servers via auth: oauth. On headless setups, Hermes may print an authorization URL to stdout or logs for you to open manually. If hermes mcp add ... --auth oauth drops into the interactive agent without saving the server entry, add the mcp_servers.context7 config manually, then run hermes mcp test context7 to trigger the auth flow and verify the connection.
Use these alternatives to run the local Context7 MCP server with other runtimes.

Bun

{
  "mcpServers": {
    "context7": {
      "command": "bunx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Deno

{
  "mcpServers": {
    "context7": {
      "command": "deno",
      "args": [
        "run",
        "--allow-env=NO_DEPRECATION,TRACE_DEPRECATION",
        "--allow-net",
        "npm:@upstash/context7-mcp"
      ]
    }
  }
}
Add the following configuration to Repository -> Settings -> Code & automation -> Copilot -> MCP servers. Only secrets named with the COPILOT_MCP_ prefix are exposed to the MCP config, so store your key as a COPILOT_MCP_CONTEXT7_API_KEY Actions secret and reference it:
{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "$COPILOT_MCP_CONTEXT7_API_KEY"
      },
      "tools": ["query-docs", "resolve-library-id"]
    }
  }
}
See the official GitHub documentation for more info.
The easiest way is the Context7 plugin, which bundles the MCP server with a skill, an agent, and a command — see GitHub Copilot CLI. For manual configuration, open ~/.copilot/mcp-config.json and add:
{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      },
      "tools": ["query-docs", "resolve-library-id"]
    }
  }
}
Or, for a local server:
{
  "mcpServers": {
    "context7": {
      "type": "local",
      "command": "npx",
      "tools": ["query-docs", "resolve-library-id"],
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
Add this to your Amazon Q Developer CLI configuration file. See Amazon Q Developer CLI docs for more details.
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
See Warp Model Context Protocol Documentation for details.
  1. Navigate Settings > Agents > MCP servers.
  2. Add a new MCP server by clicking the + Add button.
  3. Paste the configuration:
{
  "Context7": {
    "command": "npx",
    "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}
  1. Click Save.
Run this command in your terminal. See Amp MCP docs for more info.

Without API Key (Basic Usage)

amp mcp add context7 https://mcp.context7.com/mcp

With API Key (Higher Rate Limits & Private Repos)

amp mcp add context7 --header "CONTEXT7_API_KEY=YOUR_API_KEY" https://mcp.context7.com/mcp
It can be installed via Zed Extensions or you can add this to your Zed settings.json. See Zed MCP docs for more info.
{
  "context_servers": {
    "Context7": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
To install Context7 MCP Server for any client automatically via Smithery:
npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME>
See the Context7 server page on Smithery for more details.
See JetBrains AI Assistant Documentation for more details.
  1. In JetBrains IDEs, go to Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP)
  2. Click + Add.
  3. Select the HTTP or STDIO tab and paste the JSON configuration.
  4. Click Apply to save changes.

Remote Server Connection

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Local Server Connection

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
See Qwen Code MCP Configuration for details.

Using CLI Command

By default, configurations are saved to the project scope (.qwen/settings.json). Use the --scope user flag to save to the user scope (~/.qwen/settings.json) instead.

Remote Server Connection

qwen mcp add --transport http context7 https://mcp.context7.com/mcp \
  --header "CONTEXT7_API_KEY: YOUR_API_KEY" \
  --header "Accept: application/json, text/event-stream"

Local Server Connection

qwen mcp add context7 -- npx -y @upstash/context7-mcp --api-key YOUR_API_KEY

Manual Configuration

  1. Open the Qwen Code settings file at ~/.qwen/settings.json (user scope) or .qwen/settings.json (project scope)
  2. Add the following to the mcpServers object:

Remote Server Connection

{
  "mcpServers": {
    "context7": {
      "httpUrl": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY",
        "Accept": "application/json, text/event-stream"
      }
    }
  }
}

Local Server Connection

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
  1. Create a Dockerfile:
FROM node:22-alpine
WORKDIR /app
RUN npm install -g @upstash/context7-mcp
CMD ["context7-mcp", "--transport", "stdio"]
  1. Build the image:
docker build -t context7-mcp .
  1. Configure your MCP client:
{
  "mcpServers": {
    "context7": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "context7-mcp"],
      "transportType": "stdio"
    }
  }
}
If you use the Docker MCP Toolkit image (mcp/context7) with a stdio-based client, set MCP_TRANSPORT=stdio so the container starts with stdio transport instead of its HTTP default. For Cline, Roo Code, and Claude Desktop, use:
{
  "mcpServers": {
    "context7": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT=stdio", "mcp/context7"]
    }
  }
}
For VS Code, use the same Docker command in the servers format:
{
  "servers": {
    "context7": {
      "type": "stdio",
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MCP_TRANSPORT=stdio", "mcp/context7"]
    }
  }
}
Keep using the remote server URL for HTTP-based clients.
The configuration on Windows is slightly different. Use cmd to run npx:
{
  "mcpServers": {
    "context7": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
      "disabled": false,
      "autoApprove": []
    }
  }
}
See LM Studio MCP docs for more information.

One-click install:

Add MCP Server context7 to LM Studio

Manual set-up:

  1. Navigate to Program (right side) > Install > Edit mcp.json.
  2. Paste the configuration:
{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
  1. Click Save.
See Visual Studio MCP Servers documentation for details.
{
  "inputs": [],
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
Or, for a local server:
{
  "servers": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
Add this to your Crush configuration file. See Crush MCP docs for more info.

Remote Server Connection

{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Local Server Connection

{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
Open the “Settings” page, navigate to “Plugins,” and enter:
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
See BoltAI’s Documentation for more info.
Edit your Rovo Dev CLI MCP config:
acli rovodev mcp

Remote Server Connection

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Local Server Connection

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
  1. Go to the Zencoder menu (…)
  2. Select Agent tools
  3. Click on Add custom MCP
  4. Add the name and configuration:
{
  "command": "npx",
  "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
}
  1. Click Install.
See Qodo Gen docs for more details.
  1. Open Qodo Gen chat panel in VSCode or IntelliJ.
  2. Click Connect more tools.
  3. Click + Add new MCP.
  4. Add the configuration:

Local Server Connection

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}

Remote Server Connection

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}
See Local and Remote MCPs for Perplexity for more information.
  1. Navigate Perplexity > Settings
  2. Select Connectors.
  3. Click Add Connector.
  4. Select Advanced.
  5. Enter Server Name: Context7
  6. Paste:
{
  "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
  "command": "npx",
  "env": {}
}
  1. Click Save.
Factory’s droid supports MCP servers through its CLI. See Factory MCP docs for more info.

Remote Server Connection

droid mcp add context7 https://mcp.context7.com/mcp --type http --header "CONTEXT7_API_KEY: YOUR_API_KEY"

Local Server Connection

droid mcp add context7 "npx -y @upstash/context7-mcp" --env CONTEXT7_API_KEY=YOUR_API_KEY
Emdash is an orchestration layer for running multiple coding agents in parallel.Context7 is available as a built-in entry in Emdash’s MCP catalog. Enable it from the MCP view and provide your CONTEXT7_API_KEY (optional, for higher rate limits). Emdash adapts and writes the MCP config into your selected coding agent’s config (Codex, Claude Code, Cursor, etc.) for you.See the Emdash repository for more information.
Install the context7.mcpb file and add it to your client. See MCP bundles docs for more info.