Skip to main content
Glama

🐙 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

No clone required — install and run directly:

uvx github-mcp

Cursor / 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 cursor

Or 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.py

See 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 sync

2. 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

  1. Go to GitHub → Settings → Developer settings → Personal access tokens

  2. Click "Generate new token" (classic)

  3. Select scopes: repo, workflow, read:org, gist, notifications, delete_repo

  4. Click 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

github_connect

Connect with Personal Access Token

github_disconnect

Disconnect current session

github_status

Show connection status, user info, rate limits

github_save_credentials

Save credentials to disk cache

Category 2: Repository Management (10 tools)

Tool

Description

github_list_repos

List repos for authenticated user or any user/org

github_get_repo

Get detailed repo info (stars, forks, languages)

github_create_repo

Create a new repository

github_delete_repo

Delete a repository permanently

github_fork_repo

Fork a repository

github_update_repo

Update repo settings (description, visibility)

github_list_topics

Get repo topics/tags

github_update_topics

Set repo topics/tags

github_list_languages

Get language breakdown

github_list_contributors

List repo contributors

Category 3: Branch & Tag Management (8 tools)

Tool

Description

github_list_branches

List all branches

github_get_branch

Get branch details and protection status

github_create_branch

Create a new branch from a ref

github_delete_branch

Delete a branch

github_protect_branch

Set branch protection rules

github_list_tags

List all tags

github_create_tag

Create a lightweight or annotated tag

github_compare_branches

Compare two branches (ahead/behind, diff)

Category 4: File & Content Operations (6 tools)

Tool

Description

github_get_file

Get file content (auto-decodes base64)

github_create_file

Create a new file via commit

github_update_file

Update a file via commit

github_delete_file

Delete a file via commit

github_get_tree

Get directory tree listing

github_get_clone_url

Get SSH or HTTPS clone URL

Category 5: Pull Requests (10 tools)

Tool

Description

github_list_prs

List pull requests (open, closed, all)

github_get_pr

Get PR details (diff stats, reviews, status)

github_create_pr

Create a new pull request

github_update_pr

Update PR title, body, base branch

github_merge_pr

Merge a PR (merge, squash, or rebase)

github_close_pr

Close a PR without merging

github_list_pr_files

List files changed in a PR

github_list_pr_reviews

List reviews on a PR

github_request_reviewers

Request reviewers for a PR

github_create_pr_comment

Add a comment on a PR

Category 6: Issues (8 tools)

Tool

Description

github_list_issues

List issues with filters (state, labels, assignee)

github_get_issue

Get issue details

github_create_issue

Create a new issue

github_update_issue

Update issue title, body, labels, assignees

github_close_issue

Close an issue

github_create_issue_comment

Add a comment on an issue

github_list_issue_comments

List comments on an issue

github_add_labels

Add labels to an issue/PR

Category 7: Actions & CI/CD Pipelines (14 tools)

Tool

Access

Description

github_list_workflows

Read-only

List all workflows in a repo

github_trigger_workflow

Mutating

Trigger a workflow dispatch event

github_list_workflow_runs

Read-only

List workflow runs, including run_id

github_get_workflow_run

Read-only

Get details of a specific run

github_get_run_logs

Read-only

Point at the log archive without inlining it

github_cancel_workflow_run

Mutating

Cancel a running workflow

github_rerun_workflow

Mutating

Re-run every job in a workflow

github_generate_action_pipeline

Preview, or confirm to commit

Generate .github/workflows/<name>.yml for Packages, Nexus, Artifactory, or ECR/ACR/GAR, with an optional OpenShift/EKS/AKS/GKE deploy job

github_get_failed_job_logs

Read-only

Return the failing step name and a short error excerpt

github_rerun_failed_jobs

Confirm

Rerun only failed jobs

github_get_run_artifacts_metadata

Read-only

List artifact id, size, SHA256, expiry, and download URL

github_get_pending_deployments

Read-only

List environment gates waiting on a run

github_review_Pending_deployment

Confirm

Approve or reject a staging/production gate

github_check_ci_secrets_and_variables

Read-only

List variable names/values and secret names only

Category 8: Releases (5 tools)

Tool

Description

github_list_releases

List all releases

github_get_release

Get release details and assets

github_create_release

Create a release (with auto-generated notes)

github_delete_release

Delete a release

github_get_latest_release

Get the latest release

Category 9: Users & Organizations (5 tools)

Tool

Description

github_get_user

Get user profile info

github_list_user_repos

List repos for a specific user

github_get_org

Get organization info

github_list_org_repos

List repos for an organization

github_list_org_members

List organization members

Category 10: Search (4 tools)

Tool

Description

github_search_repos

Search repositories (with qualifiers)

github_search_code

Search code across GitHub

github_search_issues

Search issues and PRs

github_search_users

Search users and organizations

Category 11: Gists (4 tools)

Tool

Description

github_list_gists

List gists

github_create_gist

Create a new gist

github_get_gist

Get gist content and details

github_delete_gist

Delete a gist

Category 12: Webhooks & Notifications (2 tools)

Tool

Description

github_list_notifications

List unread notifications

github_mark_notifications_read

Mark notifications as read


🔗 SSH vs HTTPS Support

The server supports both protocols. Set your preference via:

  • Environment variable: GITHUB_PROTOCOL=ssh (or https)

  • Connection parameter: github_connect(token="...", protocol="ssh")

Feature

SSH

HTTPS

Clone URL

git@github.com:user/repo.git

https://github.com/user/repo.git

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

GITHUB_TOKEN

Yes

—

Personal Access Token

GITHUB_API_URL

No

https://api.github.com

API URL (change for GitHub Enterprise)

GITHUB_PROTOCOL

No

ssh

Preferred clone protocol (ssh or https)

GITHUB_TIMEOUT

No

30

Request timeout in seconds

GITHUB_MCP_CACHE_DIR

No

~/.github-mcp-cache

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)
"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.json with restrictive file permissions (600)

  • Never commit .env files or tokens to version control

  • Use 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 tools
github_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

    B3/5.0

    Scored across 73 tools

    Disambiguation2/5

    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.

    Naming Consistency5/5

    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.

    Tool Count1/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers