Connect GitHub MCP to Cursor
GitHub's official MCP server. Agents can read code, issues and pull requests, open PRs and leave reviews, so a design change can go from canvas to merged code.
MCP serverOfficialChecked 2026-11-16
Before you start
- Cursor installed (see its MCP documentation (opens in a new tab)).
- GitHub MCP is available on macOS, Windows and Linux.
- This setup runs GitHub's Docker image, so Docker must be installed and running. Create a fine-grained personal access token with only the repositories and permissions you need, and set it as
GITHUB_PERSONAL_ACCESS_TOKENin your environment. To skip Docker, use GitHub MCP (remote), the hosted version.
Step 1: Add GitHub MCP to Cursor
Or add it to the project
Add this to
.cursor/mcp.json, or to~/.cursor/mcp.jsonto use it in every project..cursor/mcp.json { "mcpServers": { "github": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server" ], "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "${env:GITHUB_PERSONAL_ACCESS_TOKEN}" } } } }Step 2: Check it's connected
Open Cursor Settings, find the MCP section and check the server is enabled with its tools listed.
Step 3: Try a first request
Ask Cursor something that only works with GitHub MCP connected:
Say to Cursor List the open pull requests in this repository and summarise what the newest one changes.
If it doesn't work
- Project servers live in
.cursor/mcp.json; servers for every project live in~/.cursor/mcp.json. - After editing the file by hand, toggle the server off and on in settings, or restart Cursor.
- The Output panel (MCP Logs) shows why a server failed to start.





