Skip to content

Latest commit

 

History

History

github_issue_pr_manager

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 

README.md

GitHub Issue & PR Manager

A lightweight GitHub REST API connector for AI agents and MCP workflows.

This tool can:

  • List repository issues
  • List repository pull requests
  • Get a single issue/PR by number
  • Create a new issue
  • Create a comment on an issue or pull request

Parameters

Parameter Type Required Description
action string Yes One of: list_issues, list_pull_requests, get_issue, create_issue, create_issue_comment
repo string Yes Repository in owner/repo format
state string No For list actions: open, closed, or all (default open)
per_page integer No Number of list items per page (1-100, default 10)
page integer No Page number for list actions (default 1)
include_pull_requests boolean No For list_issues, include PR items from the issues endpoint
title string No Required for create_issue
body string No Optional issue body for create_issue
labels string No Optional comma-separated labels for create_issue, e.g. bug,enhancement
issue_number integer No Required for get_issue and create_issue_comment
comment_body string No Required for create_issue_comment
github_token string No Optional token override (defaults to GITHUB_TOKEN)

Installation

pip install -r requirements.txt

Environment Variables

For write actions (create_issue, create_issue_comment), set:

export GITHUB_TOKEN="ghp_your_token_here"

Usage Example

from tool import run_tool

# 1) List issues
print(run_tool(
    action="list_issues",
    repo="tarunjandra/agent-tools-mcp-hub",
    state="open",
    per_page=5
))

# 2) List pull requests
print(run_tool(
    action="list_pull_requests",
    repo="tarunjandra/agent-tools-mcp-hub",
    state="open",
    per_page=5
))

# 3) Create issue (requires GITHUB_TOKEN)
print(run_tool(
    action="create_issue",
    repo="your-org/your-repo",
    title="Automated issue from connector",
    body="Created via github_issue_pr_manager tool.",
    labels="automation,triage"
))

# 4) Get a single issue (works for issue or PR numbers)
print(run_tool(
    action="get_issue",
    repo="tarunjandra/agent-tools-mcp-hub",
    issue_number=64
))

# 5) Create comment (requires GITHUB_TOKEN)
print(run_tool(
    action="create_issue_comment",
    repo="your-org/your-repo",
    issue_number=123,
    comment_body="Automated comment from connector tool."
))