# mcp-github-issues

MCP server exposing GitHub issue operations as tools for LLM agents (Claude Code, Claude Desktop, etc).

![Demo: Claude Code calling the github-issues MCP tool live against cli/cli](demo.gif)

## Tools

- `list_issues(repo, state, labels)` — list issues in a repo
- `create_issue(repo, title, body)` — create a new issue
- `comment_issue(repo, issue_number, body)` — comment on an issue/PR
- `close_issue(repo, issue_number)` — close an issue
- `search_issues(query)` — search issues/PRs across GitHub

## Setup

```bash
python3 -m venv venv
venv/bin/pip install -r requirements.txt
export GITHUB_TOKEN=ghp_xxx   # needs repo scope
```

## Run

```bash
venv/bin/python server.py
```

## Register with Claude Code / Claude Desktop

Add to MCP config:

```json
{
  "mcpServers": {
    "github-issues": {
      "command": "/absolute/path/to/venv/bin/python",
      "args": ["/absolute/path/to/server.py"],
      "env": { "GITHUB_TOKEN": "ghp_xxx" }
    }
  }
}
```

## Demo

See [DEMO.md](DEMO.md) for a full walkthrough: registering the server,
listing real open issues on `cli/cli` via a live Claude Code tool call,
and a create/comment/close cycle run against
[this repo's issue #1](https://github.com/adityaaravind/mcp-github-issues/issues/1).