Skip to content
MCP server

Github Tools

GitHub issues, pull requests, boards, releases and Actions for coding agents, via gh

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
0.16.0
Listing updated
today

Similar MCP servers

About Github Tools

Github Tools is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

GitHub Tools drives GitHub through the GitHub CLI, so it needs Node.js 24 or later and gh authenticated as you. The README lists issues, project boards, pull requests and native stacks, repositories, releases and Actions, organised as toolsets that can be limited, for example to issues, pull_requests and projects via a toolsets option or flag.

Tools are named per action and tagged read, add or overwrite. In the issues toolset, github_issue_read views one issue or lists a repository's issues or a parent's sub-issues with their issue fields; github_issue_create sets kind, labels, assignees, milestone, parent and blocked-by issues, issue fields and a board; github_issue_edit changes or appends to the title and body; github_issue_comment adds comments, and github_issue_close takes a reason such as completed or not planned.

The package was renamed in 0.3.0 from agent-github to github-tools, with new npm names, plugin and MCP server names and GITHUB_TOOLS_* settings, though tool IDs did not change. Delivery follows the harness: OpenCode plugin, Claude Code, Codex, Grok Build and Antigravity plugins, a Hermes plugin, or plain npm for other MCP hosts, with install pinned to a release tag or commit.

Install

Run in a terminal

claude mcp add github-tools -- npx -y @craftsamo/github-tools

Add to claude_desktop_config.json

{
  "mcpServers": {
    "github-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/github-tools"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "github-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/github-tools"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "github-tools": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/github-tools"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "github-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/github-tools"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "github-tools": {
      "command": "npx",
      "args": [
        "-y",
        "@craftsamo/github-tools"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (5)

Taken from the project documentation; the running server may differ.

github_issue_read
View one issue in full or list a repository's issues or sub-issues.
github_issue_create
Create an issue with kind, labels, assignees, milestone, parent and board.
github_issue_edit
Change or append to an issue's title, body, labels and other fields.
github_issue_comment
Comment on an issue.
github_issue_close
Close an issue with a reason.

What it does

Issue lifecycle
Read, create, edit, comment on and close issues with sub-issue and blocked-by links.
Selectable toolsets
Enable only issues, pull requests, projects and so on.
Action classes
Each tool is marked read, add or overwrite so approvals can be set.
Native stacks
Covers pull requests and GitHub's native stacks.
Per-toolset skills
A skill tells the agent how to use each toolset.
CLI-backed
Calls the authenticated gh CLI rather than a separate token.

Good for

  • File an issue with labels, assignee and parent from an agent
  • Triage and comment on issues
  • Add issues to a project board
  • Close issues with a stated reason
  • Limit an agent to issues and pull requests only

Pricing

Open source

Free npm package.

More servers for the same service

Github Tools FAQ

What does it need?

Node.js 24 or later and the GitHub CLI authenticated as you.

Did the package change names?

Yes. Version 0.3.0 renamed it from agent-github to github-tools, and tool IDs did not change.

Can I restrict which areas it touches?

Yes, choose toolsets such as issues, pull_requests and projects.

Which agents are supported?

OpenCode, Claude Code, Codex, Grok Build, Antigravity, Hermes Agent and other MCP hosts.

Is Github Tools free?

Yes. Github Tools is open source, so you can use and self-host it for free.

How do I add Github Tools to Claude Code?

Run this command in your terminal: claude mcp add github-tools -- npx -y @craftsamo/github-tools

What are the best alternatives to Github Tools?

The closest alternatives to Github Tools are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers