github-mcp-server
Provides tools for interacting with GitHub's API, enabling management of repositories, issues, pull requests, and code search.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@github-mcp-server list my recent pull requests"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GitHub MCP Server (Local)
A local MCP server that gives Claude Desktop direct access to your GitHub account via a personal access token. Runs entirely on your machine — your token never leaves your computer except to talk to GitHub's API directly.
Tools included
github_whoami— get the authenticated user's profilegithub_list_repos— list your reposgithub_get_repo— get details on a specific repogithub_search_repos— search repositoriesgithub_get_file— read a file's contents from a repogithub_list_issues— list issues in a repogithub_create_issue— create an issuegithub_list_pull_requests— list PRs in a repogithub_search_code— search code across GitHubgithub_list_commits— list commits in a repo (filter by branch, path, or author)github_get_commit— get a single commit with changed files and diff statsgithub_list_branches— list branches in a repogithub_get_issue— get full details of a single issuegithub_get_pull_request— get full details of a single PRgithub_list_pr_files— list files changed in a PRgithub_add_issue_comment— comment on an issue or PRgithub_search_issues— search issues and PRs across GitHub
Related MCP server: GitHub MCP Server
1. Prerequisites
Node.js 18+ installed on your computer
A GitHub Personal Access Token (PAT)
Create a GitHub token
Click Generate new token → Fine-grained token (recommended) or classic token
Give it a name, an expiration, and scopes:
Fine-grained: grant access to the repos you want, with Contents (read), Issues (read/write), Pull requests (read) permissions
Classic: the
reposcope covers everything above
Copy the token (starts with
github_pat_orghp_) — you won't see it again
Keep this token secret. Anyone with it can act as you on GitHub within its scopes.
2. Install
Unzip this project anywhere on your computer, then in a terminal:
cd github-mcp-server
npm install
npm run buildThis produces a dist/index.js file — that's what Claude Desktop will run.
3. Configure Claude Desktop
Open your Claude Desktop config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Add an entry under mcpServers (create the file/section if it doesn't exist),
using the absolute path to dist/index.js:
{
"mcpServers": {
"github": {
"command": "node",
"args": ["/absolute/path/to/github-mcp-server/dist/index.js"],
"env": {
"GITHUB_TOKEN": "ghp_your_token_here"
}
}
}
}Replace the path and token with your own values.
4. Restart Claude Desktop
Fully quit and reopen the app. You should see a small tools/plug icon indicating the "github" MCP server is connected, and its tools will be available in chat.
Notes
This server only runs while Claude Desktop is open — it starts/stops the process for you.
To revoke access at any time, delete the token at https://github.com/settings/tokens.
To add more capabilities (e.g. creating PRs, managing branches), extend
src/index.tswith additionalserver.tool(...)calls using the Octokit REST API.
Available Tools
9 toolsgithub_create_issueC
Create a new issue in a repository.
Inputs: repo (required), owner (required), title (required), body, +1 more.
github_get_fileB
Get the contents of a file from a GitHub repository.
Inputs: path (required), repo (required), owner (required), ref.
github_get_repoB
Get details about a specific repository.
Inputs: repo (required), owner (required).
github_list_issuesC
List issues in a repository.
Inputs: repo (required), owner (required), state, per_page.
github_list_pull_requestsC
List pull requests in a repository.
Inputs: repo (required), owner (required), state, per_page.
github_list_reposA
List repositories owned by or accessible to the authenticated user.
Inputs: sort, type, per_page.
github_search_codeA
Search code across GitHub (or within a specific repo using repo:owner/name in the query).
Inputs: query (required), per_page.
github_search_reposB
Search GitHub repositories by keyword/query.
Inputs: query (required), per_page.
github_whoamiA
Get the authenticated GitHub user's profile (login, name, email, etc).
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a distinct resource and action: user identity, code search, repo listing/detail/search, file retrieval, issue listing/creation, and pull request listing. There is no overlap or ambiguity between tools.
All tools follow a consistent `github_` prefix with snake_case naming and a verb_noun pattern (search_code, list_repos, get_repo, create_issue). The `whoami` tool slightly deviates from the noun structure but remains a recognizable verb, so the overall pattern is highly predictable.
With 9 tools, the server is well-scoped for a GitHub integration, covering common read operations (user, search, repos, files, issues, PRs) and a couple of write operations (create issue). The count feels intentional and not bloated.
The server covers the core GitHub browsing and searching workflow, including user identity, repository list/search/detail, file content, and issue list/create. Minor gaps exist such as lacking PR creation/update, issue update/delete, and repository creation, but these are not critical for a read-oriented utility.
Related MCP Connectors
An MCP server that gives your AI access to the source code and docs of all public github repos
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Create, deploy, and operate MCP servers directly from your GitHub repositories.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that enables Claude and other compatible LLMs to interact with the GitHub API, supporting features like creating issues, retrieving repository information, listing issues, and searching repositories.4ISC
- AlicenseBqualityDmaintenanceAn MCP server that allows Claude and other MCP-compatible LLMs to interact with the GitHub API, supporting features like creating issues, getting repository information, listing issues, and searching repositories.4ISC
- FlicenseNot gradedqualityDmaintenanceA working MCP server that connects to the real GitHub API, enabling users to manage repositories, issues, pull requests, and more through natural language in Claude Desktop.-
- AlicenseAqualityDmaintenanceAn MCP server that gives Claude live access to your GitHub workspace — PR reviews, issue triaging, repo search, and weekly digest reports through natural language.7MIT