Github Tools
GitHub issues, pull requests, boards, releases and Actions for coding agents, via gh
- 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-toolsAdd to claude_desktop_config.json
{
"mcpServers": {
"github-tools": {
"command": "npx",
"args": [
"-y",
"@craftsamo/github-tools"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"github-tools": {
"command": "npx",
"args": [
"-y",
"@craftsamo/github-tools"
]
}
}
}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.


