github-mcp MCP Server

A Model Context Protocol (MCP) server providing comprehensive GitHub repository operations — read and write — through a simple CLI interface. Built for Claude Desktop and other MCP clients.

Local serverstdioMIT

What is the github-mcp Server?

github-mcp is an MCP project maintained in the ildunari/github-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server providing comprehensive GitHub repository operations — read and write — through a simple CLI interface. Built for Claude Desktop…”. Read the project documentation for the complete scope.

Installation

The documented npm package is github-mcp-server-kosta. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
github_repo_infoGet repository metadata (stars, forks, language, etc.)
github_list_contentsList files/directories at a path
github_get_file_contentRead a file's content (returns SHA for updates)
github_get_readmeFetch and decode the README
github_search_codeSearch code within a repository
github_list_reposList repositories for a user/organization
github_search_reposSearch repositories globally
github_create_repoCreate a new repository
github_fork_repoFork an existing repository
github_list_issuesList issues (filter by state, labels, assignee)
github_get_issueGet full issue details
github_list_pullsList PRs (filter by state, head, base branch)
github_get_pullGet full PR details with diff stats
github_create_issueCreate a new issue
github_update_issueUpdate an issue (or PR) via Issues API (title/body/state/labels/assignees/milestone)
github_create_issue_commentComment on an issue or PR
github_create_pull_requestCreate a pull request
github_update_pull_requestUpdate a pull request
github_merge_pull_requestMerge a pull request
github_request_reviewersRequest reviewers for a pull request
github_search_issuesSearch issues and pull requests (GitHub search syntax)
github_list_branchesList all branches
github_list_commitsList commits (filter by path, author, date)
github_get_commitGet commit details with full diff
github_compareCompare two branches/tags/commits
github_create_branchCreate a new branch from a ref
github_delete_branchDelete a branch
github_list_releasesList releases with notes and assets
github_create_releaseCreate a release
github_user_infoGet user/org profile info
github_create_or_update_fileCreate or update a file via commit
github_delete_fileDelete a file via commit (requires SHA)
github_list_labelsList repository labels
github_create_labelCreate a repository label
github_set_issue_labelsReplace all labels on an issue/PR
github_add_issue_labelsAdd labels to an issue/PR
github_remove_issue_labelRemove a label from an issue/PR
github_add_labelsCompatibility alias: add labels to issue/PR
github_remove_labelCompatibility alias: remove a single label
github_tool_groups_listList tool groups and whether they are loaded
github_tool_groups_loadLoad tool groups and emit notifications/tools/list_changed
github_tool_catalog_searchSearch groups/tool names without loading all tools
github_rest_getGeneric GET against GitHub REST API (path-based)
github_rest_mutateGeneric write request (POST/PUT/PATCH/DELETE) guarded by confirm: "CONFIRM_GITHUB_WRITE"
readOnlyHintsafe to call without side effects
destructiveHintmay modify or delete data (e.g., file updates)
idempotentHintsafe to retry with same arguments
openWorldHintinteracts with external GitHub API

How to install the github-mcp Server

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "github-mcp-server-kosta",
        "--github-token",
        "YOUR_GITHUB_TOKEN"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.