MCP Server for the GitHub API, enabling file operations, repository management, search functionality, and more.
GitHub MCP Server is an MCP project maintained in the marcusdb/github-mcp-server-ts repository. The maintainer describes its purpose as “MCP Server for the GitHub API, enabling file operations, repository management, search functionality, and more”. Read the project documentation for the complete scope.
The project provides a local client configuration using docker. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.
The example declares GITHUB_PERSONAL_ACCESS_TOKEN. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| Inputs: | owner (string): Repository owner |
| branch | string): Name for new branch |
| sha | optional string): branch name |
| Returns | Success status (usually 204 No Content) |
| page | optional number): Page number |
| perPage | optional number): Results per page (max 100) |
| private | optional boolean): Whether repo should be private |
| autoInit | optional boolean): Initialize with README |
| title | optional string): New title |
| body | string): Comment text |
| assignees | optional string[]): New assignees |
| labels | optional string[]): Array of label names to set. Provide an empty array to remove all labels. |
| milestone | optional number): New milestone number |
| head | optional string): Filter by head user/org and branch |
| base | optional string): Filter by base branch |
| draft | optional boolean): Create as draft PR |
| maintainer_can_modify | optional boolean): Allow maintainer edits |
| organization | optional string): Organization to fork to |
| from_branch | optional string): Source branch (defaults to repo default) |
| state | optional string): New state ('open' or 'closed') |
| sort | optional string): Sort by ('due_on', 'completeness', default: 'due_on') |
| direction | optional string): Sort direction ('asc', 'desc', default: 'asc') |
| since | optional string): Filter by date (ISO 8601 timestamp) |
| per_page | optional number): Results per page |
| order | optional string): Sort order ('asc' or 'desc') |
| commit_id | optional string): SHA of commit to review |
| comments | optional array): Line-specific comments, each with: |
| commit_title | optional string): Title for merge commit |
| commit_message | optional string): Extra detail for merge commit |
| merge_method | optional string): Merge method ('merge', 'squash', 'rebase') |
| expected_head_sha | optional string): The expected SHA of the pull request's HEAD ref |
| color | optional string): New hex color code |
| new_name | optional string): The new name for the label |
| due_on | optional string): New due date (ISO 8601 format) |
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"GITHUB_PERSONAL_ACCESS_TOKEN",
"mcp/github"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PERSONAL_ACCESS_TOKEN"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| GITHUB_PERSONAL_ACCESS_TOKEN | Declared in the maintainer’s client configuration. | Check documentation |
Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.
Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.
Use Microsoft’s Playwright MCP server to navigate pages, inspect accessibility snapshots, fill forms and capture browser screenshots.
Connect GitHub MCP to repositories, issues and pull requests with GitHub’s hosted service or a locally run server.
Use the Supabase MCP server to inspect database schemas, query project data and retrieve docs through a project-scoped connection.
Search Linear issues and projects, inspect work context and manage updates through Linear’s hosted MCP server with OAuth.