ContextQMD
Back to Context7

MCP Clients

docs/resources/all-clients.mdx

1.0.3027.7 KB
Original Source

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.

<Tip> Looking for the easiest way to get started? Use `npx ctx7 setup` to configure Context7 automatically. See the [CLI docs](/clients/cli) for more details. </Tip> <Note> For detailed guides including rules, skills, agents, and best practices, see the dedicated client pages: - [Cursor](/clients/cursor) - Rules setup, Composer integration, tips - [Claude Code](/clients/claude-code) - Skills, agents, commands, plugin installation </Note>

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:

diff
- "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.

<AccordionGroup> <Accordion title="Claude Code">

Run this command. See Claude Code MCP docs for more info.

Local Server Connection

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

Remote Server Connection

sh
claude mcp add --scope user --header "CONTEXT7_API_KEY: YOUR_API_KEY" --transport http context7 https://mcp.context7.com/mcp
</Accordion> <Accordion title="Cursor">

Go to: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Pasting 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

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

Local Server Connection

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="Opencode">

Add this to your Opencode configuration file. See Opencode MCP docs for more info.

Remote Server Connection

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

Local Server Connection

json
{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
      "enabled": true
    }
  }
}
</Accordion> <Accordion title="OpenAI Codex">

See OpenAI Codex MCP docs for more info.

Using CLI

sh
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).

toml
[mcp_servers.context7]
command = "npx"
args = ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
startup_timeout_sec = 20

Remote Server Connection

toml
[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"
http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }
<Note> If you see startup timeout errors, try increasing `startup_timeout_sec` to `40`. </Note> </Accordion> <Accordion title="Google Antigravity">

Add this to your Antigravity MCP config file. See Antigravity MCP docs for more info.

Remote Server Connection

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

Local Server Connection

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="VS Code">

Add this to your VS Code MCP config file (.vscode/mcp.json). See VS Code MCP docs for more info.

Remote Server Connection

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

Local Server Connection

json
{
  "servers": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="Kiro">

See Kiro Model Context Protocol Documentation for details.

  1. Navigate Kiro > MCP Servers
  2. Add a new MCP server by clicking the + Add button.
  3. Paste the configuration:

Remote Server Connection

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

Local Server Connection

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
  1. Click Save to apply.
</Accordion> <Accordion title="Kilo Code">

You can configure the Context7 MCP server in Kilo Code using either the UI or by editing your project's MCP configuration file.

Kilo Code supports two configuration levels:

  • Global MCP Configuration — stored in mcp_settings.json
  • Project-level MCP Configuration — stored in .kilocode/mcp.json (recommended)

Configure via Kilo Code UI

  1. Open Kilo Code.
  2. Click the Settings icon in the top-right corner.
  3. Navigate to Settings → MCP Servers.
  4. Click Add Server.
  5. Choose HTTP Server (Streamable HTTP Transport).
  6. Enter the details:
    • URL: https://mcp.context7.com/mcp
    • Headers → Add Header
      • Key: Authorization
      • Value: Bearer YOUR_API_KEY
  7. Click Save.

Manual Configuration

Create .kilocode/mcp.json:

json
{
  "mcpServers": {
    "context7": {
      "type": "streamable-http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      },
      "alwaysAllow": [],
      "disabled": false
    }
  }
}
</Accordion> <Accordion title="Roo Code">

Add this to your Roo Code MCP configuration file. See Roo Code MCP docs for more info.

Remote Server Connection

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

Local Server Connection

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="Windsurf">

Add this to your Windsurf MCP config file. See Windsurf MCP docs for more info.

Remote Server Connection

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

Local Server Connection

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="Claude Desktop">

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.

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="ChatGPT (Web)">

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: Settings → Apps → Advanced settings → Enable Developer Mode

2. Create an App

Go to: Settings → Apps → Create App

Fill in the following:

FieldValue
NameContext7
DescriptionFetch up-to-date documentation and code examples for any library directly from the source
MCP Server URLhttps://mcp.context7.com/mcp/oauth

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.

</Accordion> <Accordion title="ChatGPT (Desktop)">

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: Settings → Apps → Advanced settings → Enable Developer Mode

2. Create an App (on the Web)

Go to: Settings → Apps → Create App

Fill in the following:

FieldValue
NameContext7
DescriptionFetch up-to-date documentation and code examples for any library directly from the source
MCP Server URLhttps://mcp.context7.com/mcp/oauth

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.

</Accordion> <Accordion title="Trae">

Use the Add manually feature and fill in the JSON configuration. See Trae documentation for more details.

Remote Server Connection

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

Local Server Connection

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="Cline">

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:
json
{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
</Accordion> <Accordion title="Augment Code">

To configure Context7 MCP in Augment Code, you can use either the graphical interface or manual configuration.

Using the Augment Code UI

  1. Click the hamburger menu.

  2. Select Settings.

  3. Navigate to the Tools section.

  4. Click the + Add MCP button.

  5. Enter the following command:

    npx -y @upstash/context7-mcp@latest

  6. Name the MCP: Context7.

  7. Click the Add button.

Manual Configuration

  1. Press Cmd/Ctrl Shift P or go to the hamburger menu in the Augment panel
  2. Select Edit Settings
  3. Under Advanced, click Edit in settings.json
  4. Add the server configuration to the mcpServers array in the augment.advanced object
json
"augment.advanced": {
  "mcpServers": [
    {
      "name": "context7",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  ]
}
</Accordion> <Accordion title="Gemini CLI">

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:
json
{
  "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:

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="Using Bun or Deno">

Use these alternatives to run the local Context7 MCP server with other runtimes.

Bun

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

Deno

json
{
  "mcpServers": {
    "context7": {
      "command": "deno",
      "args": [
        "run",
        "--allow-env=NO_DEPRECATION,TRACE_DEPRECATION",
        "--allow-net",
        "npm:@upstash/context7-mcp"
      ]
    }
  }
}
</Accordion> <Accordion title="Copilot Coding Agent">

Add the following configuration to Repository->Settings->Copilot->Coding agent->MCP configuration:

json
{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR_API_KEY"
      },
      "tools": ["query-docs", "resolve-library-id"]
    }
  }
}

See the official GitHub documentation for more info.

</Accordion> <Accordion title="Copilot CLI">

Open ~/.copilot/mcp-config.json and add:

json
{
  "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:

json
{
  "mcpServers": {
    "context7": {
      "type": "local",
      "command": "npx",
      "tools": ["query-docs", "resolve-library-id"],
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="Amazon Q Developer CLI">

Add this to your Amazon Q Developer CLI configuration file. See Amazon Q Developer CLI docs for more details.

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="Warp">

See Warp Model Context Protocol Documentation for details.

  1. Navigate Settings > AI > Manage MCP servers.
  2. Add a new MCP server by clicking the + Add button.
  3. Paste the configuration:
json
{
  "Context7": {
    "command": "npx",
    "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}
  1. Click Save.
</Accordion> <Accordion title="Amp">

Run this command in your terminal. See Amp MCP docs for more info.

Without API Key (Basic Usage)

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

With API Key (Higher Rate Limits & Private Repos)

sh
amp mcp add context7 --header "CONTEXT7_API_KEY=YOUR_API_KEY" https://mcp.context7.com/mcp
</Accordion> <Accordion title="Zed">

It can be installed via Zed Extensions or you can add this to your Zed settings.json. See Zed Context Server docs for more info.

json
{
  "context_servers": {
    "Context7": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="Smithery">

To install Context7 MCP Server for any client automatically via Smithery:

bash
npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

You can find your Smithery key in the Smithery.ai webpage.

</Accordion> <Accordion title="JetBrains AI Assistant">

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

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

Local Server Connection

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="Qwen Code">

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

sh
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

sh
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

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

Local Server Connection

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="Using Docker">
  1. Create a Dockerfile:
Dockerfile
FROM node:18-alpine
WORKDIR /app
RUN npm install -g @upstash/context7-mcp
CMD ["context7-mcp"]
  1. Build the image:
bash
docker build -t context7-mcp .
  1. Configure your MCP client:
json
{
  "mcpServers": {
    "context7": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "context7-mcp"],
      "transportType": "stdio"
    }
  }
}
</Accordion> <Accordion title="Windows">

The configuration on Windows is slightly different. Use cmd to run npx:

json
{
  "mcpServers": {
    "context7": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
      "disabled": false,
      "autoApprove": []
    }
  }
}
</Accordion> <Accordion title="LM Studio">

See LM Studio MCP Support for more information.

One-click install:

Manual set-up:

  1. Navigate to Program (right side) > Install > Edit mcp.json.
  2. Paste the configuration:
json
{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
  1. Click Save.
</Accordion> <Accordion title="Visual Studio 2022">

See Visual Studio MCP Servers documentation for details.

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

Or, for a local server:

json
{
  "mcp": {
    "servers": {
      "context7": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
      }
    }
  }
}
</Accordion> <Accordion title="Crush">

Add this to your Crush configuration file. See Crush MCP docs for more info.

Remote Server Connection

json
{
  "$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

json
{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="BoltAI">

Open the "Settings" page, navigate to "Plugins," and enter:

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

See BoltAI's Documentation for more info.

</Accordion> <Accordion title="Rovo Dev CLI">

Edit your Rovo Dev CLI MCP config:

bash
acli rovodev mcp

Remote Server Connection

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

Local Server Connection

json
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
    }
  }
}
</Accordion> <Accordion title="Zencoder">
  1. Go to the Zencoder menu (...)
  2. Select Agent tools
  3. Click on Add custom MCP
  4. Add the name and configuration:
json
{
  "command": "npx",
  "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"]
}
  1. Click Install.
</Accordion> <Accordion title="Qodo Gen">

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

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

Remote Server Connection

json
{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}
</Accordion> <Accordion title="Perplexity Desktop">

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:
json
{
  "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
  "command": "npx",
  "env": {}
}
  1. Click Save.
</Accordion> <Accordion title="Factory">

Factory's droid supports MCP servers through its CLI. See Factory MCP docs for more info.

Remote Server Connection

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

Local Server Connection

sh
droid mcp add context7 "npx -y @upstash/context7-mcp" --env CONTEXT7_API_KEY=YOUR_API_KEY
</Accordion> <Accordion title="Emdash">

Emdash is an orchestration layer for running multiple coding agents in parallel.

What Emdash provides:

  • Global toggle: Settings → MCP → "Enable Context7 MCP"
  • Per-workspace enable: The Context7 button in the ProviderBar

What you still need to do: Configure your coding agent (Codex, Claude Code, Cursor, etc.) to connect to Context7 MCP. Emdash does not modify your agent's config.

See the Emdash repository for more information.

</Accordion> <Accordion title="Desktop Extension">

Install the context7.mcpb file and add it to your client. See MCP bundles docs for more info.

</Accordion> </AccordionGroup>