# github-tools MCP server

> Enables AI agents to manage GitHub issues, pull requests, project boards, repositories, releases, and Actions via the GitHub CLI.

- Repository: https://github.com/craft-agent/github-tools
- Page: https://hostedmcp.org/servers/craft-agent/github-tools
- Transport: stdio
- Stars: 0
- Latest version: 0.15.0

## Install

### Claude Code

```sh
claude mcp add github-tools -- npx -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"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"github-tools","type":"stdio","command":"npx","args":["-y","@craftsamo/github-tools"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

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

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.github-tools]
command = "npx"
args = ["-y", "@craftsamo/github-tools"]
```

### Gemini CLI

```sh
gemini mcp add -s user github-tools npx -- -y @craftsamo/github-tools
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Tools (59)

- `github_issue_read`
- `github_issue_create`
- `github_issue_edit`
- `github_issue_comment`
- `github_issue_close`
- `github_issue_reopen`
- `github_issue_relate`
- `github_issue_develop`
- `github_pr_read`
- `github_pr_create`
- `github_pr_edit`
- `github_pr_comment`
- `github_pr_review`
- `github_pr_ready`
- `github_pr_close`
- `github_pr_reopen`
- `github_pr_merge`
- `github_stack_read`
- `github_stack_link`
- `github_stack_unlink`
- `github_project_read`
- `github_project_create`
- `github_project_field_ensure`
- `github_project_view_ensure`
- `github_project_link`
- `github_project_unlink`
- `github_project_item_add`
- `github_project_item_create`
- `github_project_item_edit`
- `github_project_item_archive`
- `github_project_item_unarchive`
- `github_project_item_convert`
- `github_repo_read`
- `github_repo_create`
- `github_repo_edit`
- `github_repo_visibility`
- `github_repo_archive`
- `github_repo_unarchive`
- `github_label_read`
- `github_label_create`
- `github_label_edit`
- `github_label_delete`
- `github_milestone_read`
- `github_milestone_create`
- `github_milestone_edit`
- `github_ruleset_read`
- `github_ruleset_create`
- `github_ruleset_edit`
- `github_ruleset_delete`
- `github_release_read`
- `github_release_create`
- `github_release_edit`
- `github_release_publish`
- `github_release_delete`
- `github_workflow_read`
- `github_run_read`
- `github_workflow_run`
- `github_run_rerun`
- `github_run_cancel`

## FAQ

### Does this tool handle pull request stacks?

Yes, it includes tools to view, link, and unlink native stacks using GitHub's REST stack endpoints.