GitHub
Repository management, issues, pull requests, and task automation
What agents can do in GitHub
add_issue_commentAdd a comment to an issue
add_pr_commentAdd a comment to a pull request
assign_issue_to_projectAdd an issue to a GitHub Projects v2 board and set field values (e.g., Status). Accepts issue_number (required), project_number or project_name to identify the project, and an optional fields object mapping field names to option values like {"Status": "Ready"}. Uses GraphQL API - requires token with project scope.
cancel_workflow_runCancel a running workflow
compare_commitsCompare two commits or branches
create_issueCreate a new issue
create_pull_requestCreate a new pull request
get_commitGet a single commit by SHA
get_issueGet a single issue by number
get_job_logsGet logs for a workflow job. For large CI logs, pass tail_bytes: 40000 - failures print at the end.
get_project_field_optionsList valid values for a single-select or iteration field on a Projects v2 board. Use this to discover canonical status / initiative / priority values before filtering. Cached 1h. Uses GraphQL API - requires token with project scope.
get_pull_requestGet a single pull request by number
get_repositoryGet repository information
get_workflow_runGet a single workflow run
list_branchesList repository branches
list_commitsList commits with filters
list_issue_commentsList comments on an issue
list_issuesList repository issues with filters. Returns a compact projection (body truncated to 300 chars as body_excerpt) to keep responses small. Call get_issue(issue_number) for the full body, or pass include_full_body=true to opt into the raw API response.
list_pr_commentsList review comments on a pull request
list_pr_filesList files changed in a pull request
list_projectsList GitHub Projects v2 boards for an organization with item counts. Use this to discover which GitHub project board to query. Returns GitHub board numbers, NOT Outermind project GUIDs - never feed these to manage_project or create_project_task; use summarize_active_work for Outermind project GUIDs. Uses GraphQL API - requires token with project scope.
list_pull_requestsList repository pull requests with filters. Returns a compact projection (body truncated to 300 chars as body_excerpt) to keep responses small. Call get_pull_request(pull_number) for the full body, or pass include_full_body=true to opt into the raw API response.
list_workflow_jobsList jobs for a workflow run
list_workflow_runsList workflow runs with filters
list_workflowsList repository workflows
merge_pull_requestMerge a pull request
query_project_itemsQuery items on a GitHub Projects v2 board with compound filters (status, initiative, labels, assignee, type, updated_since). Supports group_by for snapshot views. Returns compact items with number, title, type, status, initiative, url. Uses GraphQL API - requires token with project scope.
rerun_workflowRe-run a workflow
search_issuesSearch issues and pull requests repo- or org-wide via GitHub advanced search (GraphQL ISSUE_ADVANCED). Supports full boolean logic (AND/OR/parentheses) plus structured filters (state, type, labels, assignee, issue_type, project, updated_since) and returns an exact total match count, unbounded with cursor pagination. Complements query_project_items: advanced search cannot filter by a project board's custom Status/Initiative fields. Uses GraphQL API.
trigger_workflowTrigger a workflow dispatch event
update_issueUpdate an existing issue
update_pull_requestUpdate an existing pull request
Put GitHub on autopilot
Deploy AI agents that take these actions for you, with human-in-the-loop controls and a complete audit trail.