It’s a Planv1.12.0

Integrations/GitHub

A GitHub AI agent for your issues and discussions

The agent files, updates and comments on GitHub issues and answers discussions, from the work in your tracker. It reaches only the repositories your token allows.

GitHub Issues track ideas, feedback, tasks and bugs. Discussions hold a project’s questions, answers and announcements.

Tools
9: List, create, update and comment on issues and discussions
Key
Access token
Edition
Free in Community
Starts on
Delegate, mention, chat or a schedule

In a run

See each call the agent makes to GitHub

Every GitHub tool call is a step of the run, with what the agent sent and what came back.

Succeeded in 44sBUG-114 Export to CSV drops the last row
Agent
@triage · Internal
Trigger
Delegate
Started
Nov 21, 12:15
Run
#418

Result

GitHub issue #482 is open in acme/web with the steps, and linked in a comment.

What the agent did

  1. 12:15:31get_issue{"key":"BUG-114"}
  2. 12:15:34github_list_issues{"owner":"acme","repo":"web","state":"open"}
  3. 12:15:52github_create_issue{"owner":"acme","repo":"web","title":"…"}
  4. 12:16:09add_comment{"issue":"BUG-114"}
  5. 12:16:15The GitHub issue is linked in a comment on BUG-114.

github_create_issue12:15:52

Input{ "owner": "acme", "repo": "web", "title": "Export to CSV drops the last row", "body": "Steps\n1. Filter the table to 10 rows\n2. Export to CSV\n…" }Output{ "number": 482, "title": "Export to CSV drops the last row", "state": "open", "url": "https://github.com/acme/web/issues/482" }

Tools

Nine GitHub tools for issues and discussions

Turn on only what an agent needs. An agent can read discussions and still not open issues.

Issues

List Issues

List issues in a GitHub repository, most recently created first.

github_list_issues

Create Issue

Create an issue in a GitHub repository.

github_create_issue

Update Issue

Update an issue in a GitHub repository: change its title or markdown body, or close and reopen it.

github_update_issue

Comment Issue

Comment on an issue in a GitHub repository.

github_comment_issue

Discussions

List Discussions

List discussions in a GitHub repository, most recently updated first.

github_list_discussions

Get Discussion

Read a discussion in a GitHub repository: its markdown body, category and state, and its comments with the replies under each.

github_get_discussion

Create Discussion

Start a discussion in a GitHub repository, in one of its discussion categories.

github_create_discussion

Update Discussion

Update a discussion in a GitHub repository: change its title or markdown body, or close and reopen it.

github_update_discussion

Comment Discussion

Comment on a discussion in a GitHub repository.

github_comment_discussion

Set up

Connect GitHub once for the team

  1. Create a token

    GitHub › Settings › Developer settings

    A fine-grained token with Issues and Discussions set to Read and write, for the repositories the agent works in. A classic token needs the repo scope.

  2. Add it to the team

    Team settings › Integrations › Add credential

    Leave the instance URL empty for github.com, or enter your GitHub Enterprise address. It’s a Plan checks the token before you save it.

  3. Pick the tools

    Team settings › Tools › Add tool

    Add the GitHub tools for the team, then turn on the ones each agent may use.

Beacon›Add tool

Search tools

GitHub9 toolsSelect all
List IssuesList issues in a GitHub repository, most recently created first.
Create IssueCreate an issue in a GitHub repository.
Update IssueUpdate an issue in a GitHub repository: change its title or markdown body, or close and reopen it.
Comment IssueComment on an issue in a GitHub repository.
Credential

acme bot

Add credential
3 tools selectedCancelAdd 3 tools

Use cases

GitHub work you can hand an agent

Delegate

Delegate BUG-114 to @triage: it opens the GitHub issue in acme/web with the steps.

Schedule

Every Monday at 10:00, @triage answers the new discussions with links to the docs.

Column

When an issue moves to Done, @triage comments on the GitHub issue and closes it.

Free and Pro

GitHub comes with the free edition

FREE

GitHub and 11 more integrations, on every agent trigger: delegate, mention, chat and schedules.

PRO

HTTP tools for services not on the list, agent workflows, and an agent that starts on every new issue.

See Pro
FAQ

GitHub AI agent FAQ

Does it sync GitHub issues with the tracker?

No. There is no two-way sync. The agent reads and writes GitHub issues through the API when its task asks for it.

Can it read pull requests?

No. The GitHub tools work with issues and discussions. Pull requests, branches and checks show on an issue through the Git integration, and a merged pull request that says "Fixes KEY-42" moves the issue on.

Does it work with GitHub Enterprise?

Yes. Enter your GitHub Enterprise Server address, or your SUBDOMAIN.ghe.com address for Enterprise Cloud with data residency.

Which repositories can the agent reach?

Only those your token allows. A fine-grained token names the repositories.

Can Claude Code use the GitHub tools?

Yes. An external agent that connects over MCP with an agent’s key gets the tools turned on for that agent.

What does it cost?

The GitHub tools are free in the Community edition. You pay your AI provider for the model.

Connect GitHub to your first agent

Try the free edition on your computer with one setup command.

Or deploy to Railway in one click

AGPL-3.0 · No per-seat fees · Use your own AI key or subscription