👋 Introduction
Query any GitHub Copilot model from your AI assistant — no extra API key required.
mcp-github-copilot is a Model Context Protocol server that lets any MCP-compatible AI assistant — Claude Desktop, Claude Code CLI, Cursor, Windsurf, VSCode — query any GitHub Copilot model on your behalf.
It bridges your assistant and GitHub Copilot through the official
@github/copilot-sdk, so you can ask Claude to get a second opinion from GPT-5,
review code with Codex, or describe a screenshot with a vision-capable model —
all from inside a single conversation.
🔐 Zero extra keys
The standout feature: no extra API key, ever. The @github/copilot CLI is
bundled as a dependency, and authentication is handled entirely by that CLI. On
first run it opens a browser to authenticate automatically; afterwards it reuses
your existing GitHub Copilot CLI credentials. If you already ran gh auth login,
this MCP simply inherits it.
If you prefer a non-interactive setup, pass a GITHUB_TOKEN env var in your MCP
server config to skip the browser prompt entirely. Either way, there is no
separate OpenAI or Anthropic key to manage — your Copilot subscription is the
only credential.
✨ Features
- 🤖 Query any Copilot model — Claude, GPT-5, Codex, and more via the official
@github/copilot-sdk - 🔍 Discover models — list all available models with capabilities, context limits, and billing multipliers
- 🚀 Zero extra config — uses your existing GitHub Copilot CLI credentials automatically
- 🖼️ Image attachments — attach files or base64 images for vision-capable models
- ⚡ Modern stack — TypeScript 5+, ESM, Zod schemas, MCP 1.27
- 📦 MCP protocol — native integration with Claude Desktop, Claude Code CLI, Cursor, and more
✅ Prerequisites
- Node.js 20+
- GitHub Copilot subscription
The @github/copilot CLI is bundled as a dependency — nothing extra to install.
📦 Install
npm install -g @kud/mcp-github-copilotMinimal Claude Code config
github-copilot:
transport: stdio
command: npx
args:
- -y
- "@kud/mcp-github-copilot"🔧 Client setup
Claude Code CLI
claude mcp add --transport stdio --scope user github-copilot \
-- npx --yes @kud/mcp-github-copilot@latestVerify: claude mcp list should show github-copilot
Claude Desktop — macOS
Edit ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"github-copilot": {
"command": "npx",
"args": ["--yes", "@kud/mcp-github-copilot@latest"]
}
}
}Restart Claude Desktop.
Claude Desktop — Windows
Edit %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"github-copilot": {
"command": "npx",
"args": ["--yes", "@kud/mcp-github-copilot@latest"]
}
}
}Restart Claude Desktop.
Cursor
In Cursor settings → MCP → Add server:
{
"github-copilot": {
"command": "npx",
"args": ["--yes", "@kud/mcp-github-copilot@latest"]
}
}Windsurf
Edit ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"github-copilot": {
"command": "npx",
"args": ["--yes", "@kud/mcp-github-copilot@latest"]
}
}
}VSCode (with Copilot)
Edit .vscode/mcp.json in your workspace:
{
"servers": {
"github-copilot": {
"type": "stdio",
"command": "npx",
"args": ["--yes", "@kud/mcp-github-copilot@latest"]
}
}
}Once configured, head to Tools to see what you can do.