# Github Tools

> Github Tools is an open-source MCP server for developer tools. GitHub issues, pull requests, boards, releases and Actions for coding agents, via gh. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/craft-agent/github-tools
- **MCP Registry name:** io.github.craft-agent/github-tools
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/github-tools
