Installation

Get the Context7 MCP up and running in your favorite AI coding assistant in minutes.

Requirements

Before you begin:

MCP Client: Cursor, Claude Code, VS Code, Windsurf, or another MCP-compatible IDE
API Key (Recommended): For higher rate limits and private repositories. Get yours at context7.com/dashboard

SSE Protocol RemovedThe Server-Sent Events (SSE) transport protocol has been removed and is no longer available. Please use HTTP or stdio transport methods instead.

Recommended Post-Setup: Add a Rule to Auto-Invoke Context7After installing Context7 (see instructions below), enhance your workflow by adding a rule so you don’t have to type use context7 in every prompt. Define a simple rule in your MCP client’s rule section to automatically invoke Context7 on any code question:

For Windsurf, in .windsurfrules file
For Cursor, from Cursor Settings > Rules section
For Claude Code, in CLAUDE.md file
Or the equivalent in your MCP client

Example Rule:

Always use context7 when I need code generation, setup or
configuration steps, or library/API documentation. This means
you should automatically use the Context7 MCP tools to resolve
library id and get library docs without me having to
explicitly ask.

From then on, you’ll get Context7’s docs in any related conversation without typing anything extra. You can alter the rule to match your use cases.

Recommended Setup

For most users, we recommend:

Remote Server (HTTP) - Easier setup with no local dependencies
With API Key - Higher rate limits and access to private repositories

Quick Install

Via Smithery

Install the Context7 MCP automatically for any client via Smithery:

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

Get your Smithery key from your account at smithery.ai.

Client-Specific Installation

Cursor

Go to: Settings → Cursor Settings → MCP → Add new global MCP serverIn Cursor 1.0 and later, use the one-click button below or manually edit ~/.cursor/mcp.json.Remote Server (Recommended):

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

Local Server:

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

Claude Code

Remote Server:

claude mcp add --transport http context7 https://mcp.context7.com/mcp \
  --header "CONTEXT7_API_KEY: YOUR_API_KEY"

Local Server:

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

VS Code

Add to your VS Code MCP config:Remote Server:

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

Local Server:

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

Windsurf

Remote Server:

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

Local Server:

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

Amp

Without API Key:

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

With API Key:

amp mcp add context7 --header "CONTEXT7_API_KEY=YOUR_API_KEY" https://mcp.context7.com/mcp

Cline

Install through the Cline MCP Server Marketplace:

Open Cline
Click the hamburger menu (☰) → MCP Servers
Search for Context7 in the Marketplace tab
Click Install

Or manually edit the configuration:

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "type": "streamableHttp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Zed

Install via Zed Extensions or add to settings.json:

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

Augment Code

Via UI:

Hamburger menu → Settings → Tools
Click + Add MCP
Enter command: npx -y @upstash/context7-mcp@latest
Name: Context7

Manual Configuration:

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

Roo Code

Remote Server:

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

Local Server:

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

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)

Via Kilo Code UI:

Open Kilo Code
Click the Settings icon in the top-right corner
Navigate to Settings → MCP Servers
Click Add Server
Choose HTTP Server (Streamable HTTP Transport)
Enter URL: https://mcp.context7.com/mcp
Add Header - Key: Authorization, Value: Bearer YOUR_API_KEY
Click Save

Manual Configuration (.kilocode/mcp.json):

{
  "mcpServers": {
    "context7": {
      "type": "streamable-http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      },
      "alwaysAllow": [],
      "disabled": false
    }
  }
}

Google Antigravity

Remote Server:

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

Local Server:

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

Gemini CLI

Open ~/.gemini/settings.json and add:Remote Server:

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

Local Server:

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

Claude Desktop

Remote Server: Settings → Connectors → Add Custom Connector

Name: Context7
URL: https://mcp.context7.com/mcp

Local Server (claude_desktop_config.json):

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

Opencode

Remote Server:

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

Local Server:

{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
      "enabled": true
    }
  }
}

OpenAI Codex

Remote Server:

[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"
http_headers = { "CONTEXT7_API_KEY" = "YOUR_API_KEY" }

Local Server:

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

Windows: Use full paths if you encounter timeout errors:

[mcp_servers.context7]
command = "C:\\Program Files\\nodejs\\node.exe"
args = [
  "C:\\Users\\yourname\\AppData\\Roaming\\npm\\node_modules\\@upstash\\context7-mcp\\dist\\index.js",
  "--transport", "stdio", "--api-key", "YOUR_API_KEY"
]

macOS: Use full Node.js path if needed:

[mcp_servers.context7]
command = "/Users/yourname/.nvm/versions/node/v22.14.0/bin/node"
args = [
  "/Users/yourname/.nvm/versions/node/v22.14.0/lib/node_modules/@upstash/context7-mcp/dist/index.js",
  "--transport", "stdio", "--api-key", "YOUR_API_KEY"
]

JetBrains AI Assistant

Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
Click + Add
Select As JSON from the top-left dropdown
Add configuration:

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

Click Apply

Kiro

Navigate Kiro → MCP Servers
Click + Add
Add configuration:

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

Trae

Remote Server:

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

Local Server:

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

LM Studio

Or manually: Program → Install → Edit mcp.json:

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

Visual Studio 2022

Remote Server:

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

Local Server:

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

Crush

Remote Server:

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

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

BoltAI

Open Settings → Plugins, then add:

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

Use get-library-docs in the chat with your Context7 documentation ID.

Rovo Dev CLI

Edit your config:

acli rovodev mcp

Remote Server:

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

Local Server:

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

Zencoder

Go to Zencoder menu (…)
Select Agent tools
Click Add custom MCP
Add configuration:

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

Qodo Gen

Open the Qodo Gen chat panel
Click Connect more tools
Click + Add new MCP

Local Server:

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

Remote Server:

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

Qwen Coder

See Qwen Coder MCP Configuration for details.

Open the Qwen Coder settings file. The location is ~/.qwen/settings.json (where ~ is your home directory).
Add the following to the mcpServers object in your settings.json file:

Remote Server:

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

Local Server:

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

If the mcpServers object does not exist, create it.

Perplexity Desktop

Navigate to Perplexity → Settings → Connectors
Click Add Connector → Advanced
Server Name: Context7
Add configuration:

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

Warp

Navigate to Settings → AI → Manage MCP servers
Click + Add
Add configuration:

{
  "Context7": {
    "command": "npx",
    "args": ["-y", "@upstash/context7-mcp", "--api-key", "YOUR_API_KEY"],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}

Copilot Coding Agent

Add the following to your Copilot configuration at:Repository → Settings → Copilot → Coding agent → MCP configuration

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

Copilot CLI

Open the Copilot CLI MCP config file. The location is ~/.copilot/mcp-config.json (where ~ is your home directory).
Add the following to the mcpServers object in your mcp-config.json file:

Remote Server:

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

Local Server:

{
  "mcpServers": {
    "context7": {
      "type": "local",
      "command": "npx",
      "tools": [
        "get-library-docs",
        "resolve-library-id"
      ],
      "args": [
        "-y",
        "@upstash/context7-mcp",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

If the mcp-config.json file does not exist, create it.

Amazon Q Developer CLI

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

Windows Configuration

On Windows, configuration differs slightly. Use cmd with /c:

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

Factory

Factory’s droid supports MCP servers through its CLI. See Factory MCP docs for more info.Remote Server Connection (HTTP):Run this command in your terminal:

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

Or without an API key (basic usage with rate limits):

droid mcp add context7 https://mcp.context7.com/mcp --type http

Local Server Connection (Stdio):Run this command in your terminal:

droid mcp add context7 "npx -y @upstash/context7-mcp" --env CONTEXT7_API_KEY=YOUR_API_KEY

Once configured, Context7 tools will be available in your droid sessions. Type /mcp within droid to manage servers, authenticate, and view available tools.

Emdash

Emdash is an orchestration layer for running multiple coding agents in parallel. Provider-agnostic, worktree-isolated, and local-first.What Emdash provides:

Global toggle: Settings → MCP → “Enable Context7 MCP”
Per-workspace enable: The Context7 button in the ProviderBar (off by default). First click enables it for that workspace. Clicking again disables it.
ProviderBar: The Context7 button shows status, a short explanation, and a link to docs

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 respective MCP configuration sections above for your agent.See the Emdash repository for more information.

Alternative Runtimes

Using Bun

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

Using Deno

{
  "mcpServers": {
    "context7": {
      "command": "deno",
      "args": [
        "run",
        "--allow-env=NO_DEPRECATION,TRACE_DEPRECATION",
        "--allow-net",
        "npm:@upstash/context7-mcp"
      ]
    }
  }
}

Using Docker

Create a Dockerfile:

FROM node:18-alpine
WORKDIR /app
RUN npm install -g @upstash/context7-mcp
CMD ["context7-mcp"]

Build and configure:

docker build -t context7-mcp .

{
  "mcpServers": {
    "context7": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "context7-mcp"]
    }
  }
}

Desktop Extension

Install the context7.mcpb file. See MCP bundles docs for details.

Verify Installation

Test your setup with the MCP Inspector:

npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp

Having trouble? Check our Troubleshooting Guide for common issues and solutions.

Next Steps

Now that Context7 is installed:

Learn usage patterns - See the How-To Guides to master Context7 features like auto-invoke, specific library IDs, and token control
Get an API key - Visit the Dashboard to create an API key for higher rate limits and access to private repositories
Explore the API - Read the API Guide for direct API integration and best practices

Overview

Dashboard

SDKs

API Reference

Integrations

Resources

Requirements

Recommended Setup

Quick Install

Via Smithery

Client-Specific Installation

Alternative Runtimes

Using Bun

Using Deno

Using Docker

Desktop Extension

Verify Installation

Next Steps

Overview

Dashboard

SDKs

API Reference

Integrations

Resources

​Requirements

​Recommended Setup

​Quick Install

​Via Smithery

​Client-Specific Installation

​Alternative Runtimes

​Using Bun

​Using Deno

​Using Docker

​Desktop Extension

​Verify Installation

​Next Steps

Requirements

Recommended Setup

Quick Install

Via Smithery

Client-Specific Installation

Alternative Runtimes

Using Bun

Using Deno

Using Docker

Desktop Extension

Verify Installation

Next Steps