GitHub MCP Server
The server lets an MCP-capable AI client authenticate to GitHub and perform repo, code, PR/issue, Actions, release, search, gist, and notification operations through 73 schema tools (README advertises 80).
Manage auth/sessions with PAT, GitHub Enterprise API URL, SSH/HTTPS preference, credential cache, status and rate limits.
List, inspect, create, update, delete, or fork repositories; manage topics, languages, and contributors.
List/get/create/delete/protect branches; list/create tags; compare branches.
Read/write/delete files, inspect trees, and get SSH or HTTPS clone URLs.
List/get/create/update/merge/close PRs; inspect files/reviews; request reviewers and comment.
List/get/create/update/close issues; manage issue comments and labels.
List/trigger workflows; list/get/cancel/rerun workflow runs; get run-log download URL.
List/get/create/delete releases and fetch latest release.
Fetch user/org profiles, user/org repos, and org members.
Search repos, code, issues/PRs, and users/orgs.
List/create/get/delete gists and list/mark notifications read.
Provides comprehensive GitHub integration with 73 tools across 12 categories for managing repositories, branches, files, pull requests, issues, workflows, releases, users, organizations, search, gists, and notifications via the GitHub REST API.
Allows managing GitHub Actions workflows including listing, triggering, monitoring, canceling, and re-running workflow runs.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@GitHub MCP Server list open issues in owner/repo"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🐙 GitHub MCP Server
MCP server for GitHub operations — 80 tools for repos, PRs, issues, Actions CI/CD, releases, search, and more.
A comprehensive Model Context Protocol (MCP) server that exposes the full GitHub REST API as AI-ready tools. Connect your AI assistant (Cursor, Claude Desktop, or any MCP client) to manage GitHub through natural language.
Author: Pawan Gunjkar (pawangunjkar@gmail.com)
📥 Install
Option 1: PyPI / uvx (Recommended)
No clone required — install and run directly:
uvx github-mcpCursor / Claude Desktop — add to .cursor/mcp.json or claude_desktop_config.json:
{
"mcpServers": {
"github": {
"command": "uvx",
"args": ["github-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your-token-here",
"GITHUB_PROTOCOL": "ssh"
}
}
}
}Option 2: Smithery
npx -y @smithery/cli install github-mcp --client cursorOr browse smithery.ai and search for github-mcp.
Option 3: Clone from GitHub
git clone https://github.com/Pawangunjkar/github-mcp.git
cd github-mcp
uv sync
uv run server.pySee PUBLISHING.md for PyPI, Smithery, and directory submission steps.
Related MCP server: GitHub MCP Server
✨ Features
🔌 80 tools across 12 categories — full GitHub API coverage, including a CI/CD pipeline suite
🔐 PAT authentication — Personal Access Token with Bearer auth
🔄 SSH + HTTPS — supports both clone/push protocols
📄 Auto-pagination — transparently handles paginated API responses
⚡ Rate limit aware — tracks and warns on low rate limits
💾 Credential caching — auto-connect from env vars or cached credentials
🏢 GitHub Enterprise — configurable API URL for GHE servers
🎯 Zero configuration — just set env vars and run
🚀 Quick Start
Prerequisites
Python 3.10+
uv package manager
GitHub account with a Personal Access Token
1. Clone & Install
cd github-mcp
uv sync2. Configure Credentials
Option A: Environment Variables (Recommended)
cp .env.example .env
# Set your GitHub PAT
GITHUB_TOKEN=ghp_your-personal-access-token
GITHUB_PROTOCOL=ssh # or 'https'Option B: Connect via chat
github_connect(token="ghp_xxxxxxxxxxxx", protocol="ssh")3. Generate a Personal Access Token
Go to GitHub → Settings → Developer settings → Personal access tokens
Click "Generate new token" (classic)
Select scopes:
repo,workflow,read:org,gist,notifications,delete_repoClick Generate and copy the token
4. Run the Server
# For Cursor / Claude Desktop (stdio transport)
uv run server.py
# For testing with MCP Inspector
uv run mcp dev server.py🛠️ Tool Reference (80 Tools)
Category 1: Connection & Authentication (4 tools)
Tool | Description |
| Connect with Personal Access Token |
| Disconnect current session |
| Show connection status, user info, rate limits |
| Save credentials to disk cache |
Category 2: Repository Management (10 tools)
Tool | Description |
| List repos for authenticated user or any user/org |
| Get detailed repo info (stars, forks, languages) |
| Create a new repository |
| Delete a repository permanently |
| Fork a repository |
| Update repo settings (description, visibility) |
| Get repo topics/tags |
| Set repo topics/tags |
| Get language breakdown |
| List repo contributors |
Category 3: Branch & Tag Management (8 tools)
Tool | Description |
| List all branches |
| Get branch details and protection status |
| Create a new branch from a ref |
| Delete a branch |
| Set branch protection rules |
| List all tags |
| Create a lightweight or annotated tag |
| Compare two branches (ahead/behind, diff) |
Category 4: File & Content Operations (6 tools)
Tool | Description |
| Get file content (auto-decodes base64) |
| Create a new file via commit |
| Update a file via commit |
| Delete a file via commit |
| Get directory tree listing |
| Get SSH or HTTPS clone URL |
Category 5: Pull Requests (10 tools)
Tool | Description |
| List pull requests (open, closed, all) |
| Get PR details (diff stats, reviews, status) |
| Create a new pull request |
| Update PR title, body, base branch |
| Merge a PR (merge, squash, or rebase) |
| Close a PR without merging |
| List files changed in a PR |
| List reviews on a PR |
| Request reviewers for a PR |
| Add a comment on a PR |
Category 6: Issues (8 tools)
Tool | Description |
| List issues with filters (state, labels, assignee) |
| Get issue details |
| Create a new issue |
| Update issue title, body, labels, assignees |
| Close an issue |
| Add a comment on an issue |
| List comments on an issue |
| Add labels to an issue/PR |
Category 7: Actions & CI/CD Pipelines (14 tools)
Tool | Access | Description |
| Read-only | List all workflows in a repo |
| Mutating | Trigger a workflow dispatch event |
| Read-only | List workflow runs, including |
| Read-only | Get details of a specific run |
| Read-only | Point at the log archive without inlining it |
| Mutating | Cancel a running workflow |
| Mutating | Re-run every job in a workflow |
| Preview, or confirm to commit | Generate |
| Read-only | Return the failing step name and a short error excerpt |
| Confirm | Rerun only failed jobs |
| Read-only | List artifact id, size, SHA256, expiry, and download URL |
| Read-only | List environment gates waiting on a run |
| Confirm | Approve or reject a staging/production gate |
| Read-only | List variable names/values and secret names only |
Category 8: Releases (5 tools)
Tool | Description |
| List all releases |
| Get release details and assets |
| Create a release (with auto-generated notes) |
| Delete a release |
| Get the latest release |
Category 9: Users & Organizations (5 tools)
Tool | Description |
| Get user profile info |
| List repos for a specific user |
| Get organization info |
| List repos for an organization |
| List organization members |
Category 10: Search (4 tools)
Tool | Description |
| Search repositories (with qualifiers) |
| Search code across GitHub |
| Search issues and PRs |
| Search users and organizations |
Category 11: Gists (4 tools)
Tool | Description |
| List gists |
| Create a new gist |
| Get gist content and details |
| Delete a gist |
Category 12: Webhooks & Notifications (2 tools)
Tool | Description |
| List unread notifications |
| Mark notifications as read |
🔗 SSH vs HTTPS Support
The server supports both protocols. Set your preference via:
Environment variable:
GITHUB_PROTOCOL=ssh(orhttps)Connection parameter:
github_connect(token="...", protocol="ssh")
Feature | SSH | HTTPS |
Clone URL |
|
|
Auth | SSH key on machine | PAT or credential helper |
Default | ✅ Preferred | Fallback |
Tools like github_create_repo, github_fork_repo, and github_get_clone_url return URLs in both formats.
⚙️ Configuration
Environment Variables
Variable | Required | Default | Description |
| Yes | — | Personal Access Token |
| No |
| API URL (change for GitHub Enterprise) |
| No |
| Preferred clone protocol ( |
| No |
| Request timeout in seconds |
| No |
| Credential cache directory |
Cursor Integration
Add to .cursor/mcp.json:
{
"mcpServers": {
"github": {
"command": "uvx",
"args": ["github-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your-token-here",
"GITHUB_PROTOCOL": "ssh"
}
}
}
}Alternative (from source):
{
"mcpServers": {
"github": {
"command": "uv",
"args": ["run", "--directory", "/path/to/github-mcp", "server.py"],
"env": {
"GITHUB_TOKEN": "ghp_your-token-here",
"GITHUB_PROTOCOL": "ssh"
}
}
}
}Claude Desktop Integration
Add to claude_desktop_config.json:
{
"mcpServers": {
"github": {
"command": "uvx",
"args": ["github-mcp"],
"env": {
"GITHUB_TOKEN": "ghp_your-token-here",
"GITHUB_PROTOCOL": "ssh"
}
}
}
}💡 Example Usage
Repository Management
"List all my repos sorted by recent activity"
→ github_list_repos(sort="updated")
"Show me the details of the linux-ssh-mcp repo"
→ github_get_repo(owner="Pawangunjkar", repo="linux-ssh-mcp")
"Fork the fastapi repo to my account"
→ github_fork_repo(owner="tiangolo", repo="fastapi")Pull Requests & Code Review
"Create a PR from feature-branch to main"
→ github_create_pr(owner="me", repo="my-app", title="Add login feature", head="feature-branch", base="main")
"Show me the files changed in PR #42"
→ github_list_pr_files(owner="me", repo="my-app", pr_number=42)
"Merge PR #42 with squash"
→ github_merge_pr(owner="me", repo="my-app", pr_number=42, merge_method="squash")GitHub Actions
"Trigger the deploy workflow on main branch"
→ github_trigger_workflow(owner="me", repo="my-app", workflow_id="deploy.yml", ref="main")
"Show recent workflow runs"
→ github_list_workflow_runs(owner="me", repo="my-app")
"Cancel the running workflow"
→ github_cancel_workflow_run(owner="me", repo="my-app", run_id=12345)
"Why did run 12345 fail?"
→ github_get_failed_job_logs(owner="me", repo="my-app", run_id=12345)
"Rerun only the failed jobs"
→ github_rerun_failed_jobs(owner="me", repo="my-app", run_id=12345, confirm=true)Search
"Find popular Python MCP servers on GitHub"
→ github_search_repos(query="mcp server language:python stars:>10")
"Search for FastMCP usage in code"
→ github_search_code(query="FastMCP language:python")📁 Project Structure
github-mcp/
├── server.py # Main MCP server — tool definitions and registration
├── actions_tools.py # Actions and CI/CD pipeline tools (14)
├── actions_ci.py # Workflow renderer and failed-log excerpts
├── github_client.py # GitHub REST API client (HTTP, auth, pagination)
├── credential_store.py # Credential caching (env vars, memory, file)
├── agensi_build/ # Agensi.io skill package source
├── scripts/build_agensi_zip.py
├── pyproject.toml # Project metadata & dependencies
├── .env.example # Example environment variables
├── .gitignore # Python gitignore
├── LICENSE # MIT license
└── README.md # This file🔒 Security Notes
PAT tokens are stored in
~/.github-mcp-cache/credentials.jsonwith restrictive file permissions (600)Never commit
.envfiles or tokens to version controlUse fine-grained tokens when possible for minimum required access
The server tracks rate limits and warns when running low
📄 License
MIT License — see LICENSE for details.
Available Tools
73 toolsgithub_add_labelsA
Add labels to an issue or pull request.
Args: owner: Repository owner repo: Repository name issue_number: Issue or PR number labels: Comma-separated label names to add session_name: GitHub session to use
Inputs: repo (required), owner (required), labels (required), issue_number (required), +1 more. Returns: result
github_cancel_workflow_runA
Cancel a workflow run that is in progress.
Args: owner: Repository owner repo: Repository name run_id: Workflow run ID to cancel session_name: GitHub session to use
Inputs: repo (required), owner (required), run_id (required), session_name. Returns: result
github_close_issueB
Close an issue.
Args: owner: Repository owner repo: Repository name issue_number: Issue number to close session_name: GitHub session to use
Inputs: repo (required), owner (required), issue_number (required), session_name. Returns: result
github_close_prA
Close a pull request without merging.
Args: owner: Repository owner repo: Repository name pr_number: PR number to close session_name: GitHub session to use
Inputs: repo (required), owner (required), pr_number (required), session_name. Returns: result
github_compare_branchesA
Compare two branches showing ahead/behind counts and changed files.
Args: owner: Repository owner repo: Repository name base: Base branch (e.g., 'main') head: Head branch to compare (e.g., 'feature-branch') session_name: GitHub session to use
Inputs: base (required), head (required), repo (required), owner (required), +1 more. Returns: result
github_connectA
Connect to GitHub API with a Personal Access Token.
Credentials are automatically cached for future reconnection.
Args: token: GitHub Personal Access Token (generate at https://github.com/settings/tokens) api_url: GitHub API URL (default: https://api.github.com, change for GitHub Enterprise) protocol: Preferred clone/push protocol — 'ssh' or 'https' (default: ssh) timeout: Request timeout in seconds (default: 30) session_name: Name for this session (default: 'default')
Inputs: token (required), api_url, timeout, protocol, +1 more. Returns: result
github_create_branchA
Create a new branch from an existing branch or commit SHA.
Args: owner: Repository owner repo: Repository name branch_name: Name for the new branch from_branch: Source branch name (default: repo's default branch) from_sha: Specific commit SHA to branch from (overrides from_branch) session_name: GitHub session to use
Inputs: repo (required), owner (required), branch_name (required), from_sha, +2 more. Returns: result
github_create_fileA
Create a new file in a repository via a commit.
Args: owner: Repository owner repo: Repository name path: File path to create (e.g., 'docs/guide.md') content: File content (will be base64-encoded automatically) message: Commit message branch: Branch to commit to (empty = default branch) session_name: GitHub session to use
Inputs: path (required), repo (required), owner (required), content (required), +3 more. Returns: result
github_create_gistA
Create a new gist with one or more files.
Args: files: JSON string mapping filenames to content, e.g. '{"hello.py": "print("hello")", "readme.md": "# Hello"}' description: Gist description public: Make gist public (default: False = secret) session_name: GitHub session to use
Inputs: files (required), public, description, session_name. Returns: result
github_create_issueA
Create a new issue in a repository.
Args: owner: Repository owner repo: Repository name title: Issue title body: Issue body (markdown supported) labels: Comma-separated label names (e.g., 'bug,priority:high') assignees: Comma-separated usernames to assign session_name: GitHub session to use
Inputs: repo (required), owner (required), title (required), body, +3 more. Returns: result
github_create_issue_commentB
Add a comment on an issue.
Args: owner: Repository owner repo: Repository name issue_number: Issue number body: Comment body (markdown supported) session_name: GitHub session to use
Inputs: body (required), repo (required), owner (required), issue_number (required), +1 more. Returns: result
github_create_prA
Create a new pull request.
Args: owner: Repository owner repo: Repository name title: PR title head: Source branch name (e.g., 'feature-branch') base: Target branch name (e.g., 'main') body: PR description/body (markdown supported) draft: Create as draft PR (default: False) session_name: GitHub session to use
Inputs: base (required), head (required), repo (required), owner (required), +4 more. Returns: result
github_create_pr_commentA
Add a comment on a pull request.
Args: owner: Repository owner repo: Repository name pr_number: PR number body: Comment body (markdown supported) session_name: GitHub session to use
Inputs: body (required), repo (required), owner (required), pr_number (required), +1 more. Returns: result
github_create_releaseA
Create a new release with auto-generated or custom release notes.
Args: owner: Repository owner repo: Repository name tag_name: Tag name for the release (e.g., 'v1.0.0') name: Release title (default: tag name) body: Release notes body (markdown) target: Branch or commit SHA (default: default branch) draft: Create as draft (default: False) prerelease: Mark as pre-release (default: False) generate_notes: Auto-generate release notes (default: False) session_name: GitHub session to use
Inputs: repo (required), owner (required), tag_name (required), body, +6 more. Returns: result
github_create_repoA
Create a new GitHub repository.
Args: name: Repository name description: Repository description private: Make repository private (default: False = public) auto_init: Initialize with a README (default: True) gitignore_template: Gitignore template name (e.g., 'Python', 'Node', 'Go') license_template: License template (e.g., 'mit', 'apache-2.0', 'gpl-3.0') org: Organization to create repo under (empty = personal repo) session_name: GitHub session to use
Inputs: name (required), org, private, auto_init, +4 more. Returns: result
github_create_tagA
Create a new tag (lightweight or annotated).
Args: owner: Repository owner repo: Repository name tag_name: Tag name (e.g., 'v1.0.0') sha: Commit SHA to tag message: Tag message (if provided, creates an annotated tag) session_name: GitHub session to use
Inputs: sha (required), repo (required), owner (required), tag_name (required), +2 more. Returns: result
github_delete_branchC
Delete a branch from a repository.
Args: owner: Repository owner repo: Repository name branch: Branch name to delete session_name: GitHub session to use
Inputs: repo (required), owner (required), branch (required), session_name. Returns: result
github_delete_fileB
Delete a file from a repository via a commit.
Args: owner: Repository owner repo: Repository name path: File path to delete message: Commit message sha: Current file SHA (get from github_get_file) branch: Branch to commit to (empty = default branch) session_name: GitHub session to use
Inputs: sha (required), path (required), repo (required), owner (required), +3 more. Returns: result
github_delete_gistA
Delete a gist permanently.
Args: gist_id: Gist ID to delete session_name: GitHub session to use
Inputs: gist_id (required), session_name. Returns: result
github_delete_releaseB
Delete a release (the tag is NOT deleted).
Args: owner: Repository owner repo: Repository name release_id: Release ID to delete session_name: GitHub session to use
Inputs: repo (required), owner (required), release_id (required), session_name. Returns: result
github_delete_repoA
Delete a GitHub repository permanently.
⚠️ This action cannot be undone. All data, issues, PRs, and wiki will be lost.
Args: owner: Repository owner repo: Repository name session_name: GitHub session to use
Inputs: repo (required), owner (required), session_name. Returns: result
github_disconnectC
Disconnect a GitHub session.
Args: session_name: Name of the session to disconnect (default: 'default')
Inputs: session_name. Returns: result
github_fork_repoC
Fork a repository to your account or an organization.
Args: owner: Original repo owner repo: Original repo name org: Organization to fork to (empty = your personal account) new_name: Custom name for the fork (empty = keep original name) session_name: GitHub session to use
Inputs: repo (required), owner (required), org, new_name, +1 more. Returns: result
github_get_branchA
Get detailed information about a specific branch.
Args: owner: Repository owner repo: Repository name branch: Branch name session_name: GitHub session to use
Inputs: repo (required), owner (required), branch (required), session_name. Returns: result
github_get_clone_urlA
Get the clone URL for a repository in SSH or HTTPS format.
Args: owner: Repository owner repo: Repository name protocol: 'ssh' or 'https' (empty = use session default) session_name: GitHub session to use
Inputs: repo (required), owner (required), protocol, session_name. Returns: result
github_get_fileA
Get file content from a repository (auto-decodes base64).
Args: owner: Repository owner repo: Repository name path: File path in the repo (e.g., 'src/main.py') ref: Branch, tag, or commit SHA (empty = default branch) session_name: GitHub session to use
Inputs: path (required), repo (required), owner (required), ref, +1 more. Returns: result
github_get_gistC
Get gist content and details.
Args: gist_id: Gist ID session_name: GitHub session to use
Inputs: gist_id (required), session_name. Returns: result
github_get_issueC
Get detailed information about an issue.
Args: owner: Repository owner repo: Repository name issue_number: Issue number session_name: GitHub session to use
Inputs: repo (required), owner (required), issue_number (required), session_name. Returns: result
github_get_latest_releaseB
Get the latest published release for a repository.
Args: owner: Repository owner repo: Repository name session_name: GitHub session to use
Inputs: repo (required), owner (required), session_name. Returns: result
github_get_orgB
Get organization information.
Args: org: Organization name session_name: GitHub session to use
Inputs: org (required), session_name. Returns: result
github_get_prB
Get detailed information about a pull request.
Args: owner: Repository owner repo: Repository name pr_number: PR number session_name: GitHub session to use
Inputs: repo (required), owner (required), pr_number (required), session_name. Returns: result
github_get_releaseA
Get details of a specific release.
Args: owner: Repository owner repo: Repository name release_id: Release ID (use either this or tag) tag: Release tag name (e.g., 'v1.0.0') session_name: GitHub session to use
Inputs: repo (required), owner (required), tag, release_id, +1 more. Returns: result
github_get_repoB
Get detailed information about a specific repository.
Shows stars, forks, languages, default branch, license, and more.
Args: owner: Repository owner (user or org) repo: Repository name session_name: GitHub session to use
Inputs: repo (required), owner (required), session_name. Returns: result
github_get_run_logsA
Get the download URL for workflow run logs (returns a redirect URL).
Args: owner: Repository owner repo: Repository name run_id: Workflow run ID session_name: GitHub session to use
Inputs: repo (required), owner (required), run_id (required), session_name. Returns: result
github_get_treeA
Get directory listing/tree for a repository path.
Args: owner: Repository owner repo: Repository name path: Directory path (empty = root) ref: Branch, tag, or SHA (empty = default branch) session_name: GitHub session to use
Inputs: repo (required), owner (required), ref, path, +1 more. Returns: result
github_get_userA
Get user profile information (authenticated user if username is empty).
Args: username: GitHub username (empty = authenticated user) session_name: GitHub session to use
Inputs: username, session_name. Returns: result
github_get_workflow_runC
Get details of a specific workflow run.
Args: owner: Repository owner repo: Repository name run_id: Workflow run ID session_name: GitHub session to use
Inputs: repo (required), owner (required), run_id (required), session_name. Returns: result
github_list_branchesC
List all branches in a repository.
Args: owner: Repository owner repo: Repository name max_results: Maximum branches to return (default: 30) session_name: GitHub session to use
Inputs: repo (required), owner (required), max_results, session_name. Returns: result
github_list_contributorsC
List repository contributors with commit counts.
Args: owner: Repository owner repo: Repository name max_results: Maximum contributors to return (default: 30) session_name: GitHub session to use
Inputs: repo (required), owner (required), max_results, session_name. Returns: result
github_list_gistsA
List gists for the authenticated user or a specific user.
Args: username: GitHub username (empty = authenticated user) max_results: Maximum gists to return (default: 20) session_name: GitHub session to use
Inputs: username, max_results, session_name. Returns: result
github_list_issue_commentsA
List comments on an issue.
Args: owner: Repository owner repo: Repository name issue_number: Issue number max_results: Maximum comments to return (default: 30) session_name: GitHub session to use
Inputs: repo (required), owner (required), issue_number (required), max_results, +1 more. Returns: result
github_list_issuesA
List issues in a repository with optional filters.
Args: owner: Repository owner repo: Repository name state: Filter — 'open', 'closed', 'all' (default: open) labels: Comma-separated label names to filter by assignee: Filter by assignee username sort: Sort by — 'created', 'updated', 'comments' (default: created) max_results: Maximum issues to return (default: 30) session_name: GitHub session to use
Inputs: repo (required), owner (required), sort, state, +4 more. Returns: result
github_list_languagesB
Get the language breakdown for a repository (bytes per language).
Args: owner: Repository owner repo: Repository name session_name: GitHub session to use
Inputs: repo (required), owner (required), session_name. Returns: result
github_list_notificationsA
List GitHub notifications for the authenticated user.
Args: all_notifications: Show all notifications including read ones (default: False = unread only) participating: Only show notifications where user is participating (default: False) max_results: Maximum notifications to return (default: 30) session_name: GitHub session to use
Inputs: max_results, session_name, participating, all_notifications. Returns: result
github_list_org_membersA
List members of an organization.
Args: org: Organization name max_results: Maximum members to return (default: 50) session_name: GitHub session to use
Inputs: org (required), max_results, session_name. Returns: result
github_list_org_reposA
List repositories for an organization.
Args: org: Organization name repo_type: Filter — 'all', 'public', 'private', 'forks', 'sources' (default: all) sort: Sort by — 'updated', 'created', 'pushed', 'full_name' max_results: Maximum repos (default: 30) session_name: GitHub session to use
Inputs: org (required), sort, repo_type, max_results, +1 more. Returns: result
github_list_pr_filesB
List files changed in a pull request.
Args: owner: Repository owner repo: Repository name pr_number: PR number session_name: GitHub session to use
Inputs: repo (required), owner (required), pr_number (required), session_name. Returns: result
github_list_pr_reviewsA
List reviews on a pull request.
Args: owner: Repository owner repo: Repository name pr_number: PR number session_name: GitHub session to use
Inputs: repo (required), owner (required), pr_number (required), session_name. Returns: result
github_list_prsA
List pull requests for a repository.
Args: owner: Repository owner repo: Repository name state: Filter — 'open', 'closed', 'all' (default: open) sort: Sort by — 'created', 'updated', 'popularity' (default: created) max_results: Maximum PRs to return (default: 30) session_name: GitHub session to use
Inputs: repo (required), owner (required), sort, state, +2 more. Returns: result
github_list_releasesA
List all releases for a repository.
Args: owner: Repository owner repo: Repository name max_results: Maximum releases to return (default: 20) session_name: GitHub session to use
Inputs: repo (required), owner (required), max_results, session_name. Returns: result
github_list_reposA
List repositories for the authenticated user or a specific user/org.
Args: owner: Username or org name (empty = authenticated user's repos) repo_type: Filter — 'all', 'owner', 'public', 'private', 'member' (default: all) sort: Sort by — 'updated', 'created', 'pushed', 'full_name' (default: updated) max_results: Maximum number of repos to return (default: 30) session_name: GitHub session to use
Inputs: sort, owner, repo_type, max_results, +1 more. Returns: result
github_list_tagsA
List all tags in a repository.
Args: owner: Repository owner repo: Repository name max_results: Maximum tags to return (default: 30) session_name: GitHub session to use
Inputs: repo (required), owner (required), max_results, session_name. Returns: result
github_list_topicsC
Get repository topics/tags.
Args: owner: Repository owner repo: Repository name session_name: GitHub session to use
Inputs: repo (required), owner (required), session_name. Returns: result
github_list_user_reposA
List public repositories for a specific user.
Args: username: GitHub username sort: Sort by — 'updated', 'created', 'pushed', 'full_name' (default: updated) max_results: Maximum repos (default: 30) session_name: GitHub session to use
Inputs: username (required), sort, max_results, session_name. Returns: result
github_list_workflow_runsB
List workflow runs for a repository or specific workflow.
Args: owner: Repository owner repo: Repository name workflow_id: Specific workflow ID or filename (empty = all workflows) status: Filter — 'completed', 'in_progress', 'queued', 'success', 'failure' branch: Filter by branch name max_results: Maximum runs to return (default: 20) session_name: GitHub session to use
Inputs: repo (required), owner (required), branch, status, +3 more. Returns: result
github_list_workflowsB
List all GitHub Actions workflows in a repository.
Args: owner: Repository owner repo: Repository name session_name: GitHub session to use
Inputs: repo (required), owner (required), session_name. Returns: result
github_mark_notifications_readA
Mark all notifications as read.
Args: last_read_at: ISO 8601 timestamp — mark notifications before this as read (empty = all) session_name: GitHub session to use
Inputs: last_read_at, session_name. Returns: result
github_merge_prB
Merge a pull request.
Args: owner: Repository owner repo: Repository name pr_number: PR number to merge merge_method: Merge strategy — 'merge', 'squash', or 'rebase' (default: merge) commit_title: Custom merge commit title (empty = default) commit_message: Custom merge commit message (empty = default) session_name: GitHub session to use
Inputs: repo (required), owner (required), pr_number (required), commit_title, +3 more. Returns: result
github_protect_branchB
Set branch protection rules.
Args: owner: Repository owner repo: Repository name branch: Branch name to protect require_reviews: Require pull request reviews (default: True) required_reviewers: Minimum number of reviewers (default: 1) enforce_admins: Enforce rules for admins too (default: False) session_name: GitHub session to use
Inputs: repo (required), owner (required), branch (required), session_name, +3 more. Returns: result
github_request_reviewersB
Request reviewers for a pull request.
Args: owner: Repository owner repo: Repository name pr_number: PR number reviewers: Comma-separated GitHub usernames (e.g., 'user1,user2') session_name: GitHub session to use
Inputs: repo (required), owner (required), pr_number (required), reviewers (required), +1 more. Returns: result
github_rerun_workflowC
Re-run a workflow (all jobs or only failed jobs).
Args: owner: Repository owner repo: Repository name run_id: Workflow run ID to re-run session_name: GitHub session to use
Inputs: repo (required), owner (required), run_id (required), session_name. Returns: result
github_save_credentialsB
Save GitHub credentials to disk cache for future use.
Args: session_name: Name to save credentials under token: GitHub Personal Access Token api_url: GitHub API URL protocol: Preferred clone protocol — 'ssh' or 'https'
Inputs: token (required), session_name (required), api_url, protocol. Returns: result
github_search_codeA
Search code across GitHub.
Supports qualifiers: repo:owner/repo, path:src/, extension:py, language:python, etc.
Args: query: Code search query (e.g., 'FastMCP language:python') max_results: Maximum results (default: 20) session_name: GitHub session to use
Inputs: query (required), max_results, session_name. Returns: result
github_search_issuesA
Search issues and pull requests across GitHub.
Supports qualifiers: repo:owner/repo, is:issue, is:pr, state:open, label:bug, etc.
Args: query: Search query (e.g., 'is:issue state:open label:bug repo:owner/repo') sort: Sort by — 'created', 'updated', 'comments', 'reactions' (default: created) max_results: Maximum results (default: 20) session_name: GitHub session to use
Inputs: query (required), sort, max_results, session_name. Returns: result
github_search_reposA
Search GitHub repositories by query.
Supports GitHub search qualifiers: language:python, stars:>100, topic:mcp, etc.
Args: query: Search query (e.g., 'mcp server language:python stars:>10') sort: Sort by — 'stars', 'forks', 'updated', 'help-wanted-issues' (default: stars) max_results: Maximum results (default: 20) session_name: GitHub session to use
Inputs: query (required), sort, max_results, session_name. Returns: result
github_search_usersA
Search GitHub users and organizations.
Supports qualifiers: type:user, type:org, location:india, language:python, etc.
Args: query: Search query (e.g., 'type:org language:python') sort: Sort by — 'followers', 'repositories', 'joined' (default: followers) max_results: Maximum results (default: 20) session_name: GitHub session to use
Inputs: query (required), sort, max_results, session_name. Returns: result
github_statusA
Show connection status, authenticated user info, and API rate limits.
Args: session_name: Session to check (default: 'default')
Inputs: session_name. Returns: result
github_trigger_workflowA
Trigger a workflow dispatch event (manually run a workflow).
The workflow must have a 'workflow_dispatch' trigger defined.
Args: owner: Repository owner repo: Repository name workflow_id: Workflow ID or filename (e.g., 'deploy.yml') ref: Branch or tag to run on (default: main) inputs: Workflow inputs as JSON string (e.g., '{"environment": "staging"}') session_name: GitHub session to use
Inputs: repo (required), owner (required), workflow_id (required), ref, +2 more. Returns: result
github_update_fileA
Update an existing file in a repository via a commit.
You need the current file's SHA (get it from github_get_file).
Args: owner: Repository owner repo: Repository name path: File path to update content: New file content message: Commit message sha: Current file SHA (required to prevent conflicts) branch: Branch to commit to (empty = default branch) session_name: GitHub session to use
Inputs: sha (required), path (required), repo (required), owner (required), +4 more. Returns: result
github_update_issueA
Update an issue's title, body, labels, assignees, or state.
Args: owner: Repository owner repo: Repository name issue_number: Issue number title: New title (empty = no change) body: New body (empty = no change) labels: Comma-separated labels (replaces all labels; empty = no change) assignees: Comma-separated assignees (replaces all; empty = no change) state: 'open' or 'closed' (empty = no change) session_name: GitHub session to use
Inputs: repo (required), owner (required), issue_number (required), body, +5 more. Returns: result
github_update_prA
Update a pull request's title, body, base branch, or state.
Args: owner: Repository owner repo: Repository name pr_number: PR number title: New title (empty = no change) body: New body (empty = no change) base: New base branch (empty = no change) state: New state — 'open' or 'closed' (empty = no change) session_name: GitHub session to use
Inputs: repo (required), owner (required), pr_number (required), base, +4 more. Returns: result
github_update_repoA
Update repository settings.
Only provided fields will be updated. Leave empty to keep current value.
Args: owner: Repository owner repo: Repository name description: New description (empty = no change) homepage: Homepage URL (empty = no change) private: 'true' or 'false' (empty = no change) archived: 'true' to archive (empty = no change) default_branch: New default branch name (empty = no change) session_name: GitHub session to use
Inputs: repo (required), owner (required), private, archived, +4 more. Returns: result
github_update_topicsA
Set repository topics/tags (replaces all existing topics).
Args: owner: Repository owner repo: Repository name topics: Comma-separated topic names (e.g., 'python,mcp,devops') session_name: GitHub session to use
Inputs: repo (required), owner (required), topics (required), session_name. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 73 tools
Multiple tools have overlapping purposes, such as github_list_repos, github_list_user_repos, and github_list_org_repos, where the first already supports owner filtering. Similarly, close_issue and close_pr duplicate the state-changing capabilities of update_issue and update_pr, creating ambiguity about the preferred tool. While descriptions are clear, the boundaries between these tools are not distinct enough for an agent to reliably choose.
All tool names follow a consistent 'github_verb_noun' pattern using snake_case, such as github_list_repos, github_create_branch, and github_merge_pr. The prefix and verb-first structure are uniform across the entire set, making the naming highly predictable and easy to navigate.
With 73 tools, this server vastly exceeds the typical 3-15 tool range and even the 50+ extreme threshold. Many tools are redundant or could be consolidated (e.g., repo listing variants, close vs update), inflating the count and overwhelming agents with too many choices.
The server provides broad coverage across repos, branches, files, PRs, issues, workflows, releases, users, search, gists, and notifications. However, notable gaps exist, such as lack of commit history APIs, no update for gists or releases, and no PR review submission, which are significant for a complete GitHub lifecycle.
Maintenance
Related MCP Connectors
An MCP server that gives your AI access to the source code and docs of all public github repos
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
Create, deploy, and operate MCP servers directly from your GitHub repositories.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Related MCP Servers
- AlicenseBqualityCmaintenanceMCP server that exposes GitHub operations as tools for AI agents, enabling code search, issue management, and PR review.1236 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that provides tools for interacting with the GitHub API, enabling AI assistants to query repositories, pull requests, issues, commits, users, and more.497 npmISC
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables GitHub API operations such as managing repositories, issues, and pull requests through natural language.Apache 2.0
- AlicenseNot gradedqualityBmaintenanceMCP server providing maximum practical control over GitHub via REST and GraphQL APIs, exposing 22 tools for repository management, file operations, issues, PRs, Actions, and more.MIT