MCPInstall

github-mcp

by oimiragieoAI & Agents

GitHub API operations - repositories, issues, pull requests, actions, code security, discussions, gists, and more. Use for GitHub-related tasks like managing PRs, issues, searching code, and monitoring workflows.

Installs
81
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/oimiragieo/agent-studio --skill github-mcp
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads github-mcp automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Mode: Cognitive/Prompt-Driven — No standalone utility script; use via agent context.

GitHub Skill

Overview

This skill provides access to the official GitHub MCP server with progressive disclosure for optimal context usage.

Context Savings: ~95% reduction

  • MCP Mode: ~50,000 tokens always loaded (80+ tools)
  • Skill Mode: ~500 tokens metadata + on-demand loading

Requirements

  • Docker installed and running
  • GITHUB_PERSONAL_ACCESS_TOKEN environment variable set

Toolsets

The server provides 80+ tools across 19 toolsets:

ToolsetDescription
actionsWorkflow management, runs, jobs, artifacts
code_securityScanning alerts, code analysis
discussionsForum interactions
gistsCode snippets management
issuesIssue creation, updates, commenting
labelsLabel management and filtering
projectsGitHub Projects board management
pull_requestsPR creation, review, merging
reposCode search, commits, releases, branches
usersUser search and management
orgsOrganization and team management
notificationsNotification management
secret_scanningSecret scanning alerts
contextContext about the user

Quick Reference

Use the gh CLI for GitHub operations:

# Get repository info
gh repo view anthropics/claude-code

# List issues
gh issue list --repo anthropics/claude-code

# Search code
gh search code "language:python MCP"

# Create issue
gh issue create --repo me/myrepo --title "Bug" --body "Description"

# List pull requests
gh pr list --repo anthropics/claude-code

Common Tools (Default Toolsets: 40 tools)

Repository Operations

  • search_repositories - Search for repositories
  • create_repository - Create a new repository
  • fork_repository - Fork a repository
  • list_commits - List repository commits
  • get_commit - Get commit details
  • get_file_contents - Get file contents from a repository
  • create_or_update_file - Create or update a file
  • delete_file - Delete a file
  • push_files - Push multiple files
  • search_code - Search for code across GitHub
  • list_branches - List repository branches
  • create_branch - Create a new branch
  • list_tags - List repository tags
  • get_tag - Get tag details
  • list_releases - List releases
  • get_latest_release - Get latest release
  • get_release_by_tag - Get release by tag

Issue Operations

  • list_issues - List repository issues
  • issue_read - Read issue details
  • issue_write - Create/update issues
  • add_issue_comment - Add a comment to an issue
  • search_issues - Search for issues
  • list_issue_types - List issue types (for organizations)
  • get_label - Get label details
  • sub_issue_write - Manage sub-issues
  • assign_copilot_to_issue - Assign Copilot to an issue

Pull Request Operations

  • list_pull_requests - List repository pull requests
  • pull_request_read - Read PR details
  • create_pull_request - Create a new PR
  • update_pull_request - Update a PR
  • update_pull_request_branch - Update PR branch
  • merge_pull_request - Merge a PR
  • search_pull_requests - Search for pull requests
  • pull_request_review_write - Create/submit PR reviews
  • add_comment_to_pending_review - Add comments to pending review
  • request_copilot_review - Request Copilot review

User & Team Operations

  • get_me - Get current authenticated user
  • search_users - Search for users
  • get_teams - Get organization teams
  • get_team_members - Get team members

Configuration

The skill uses Docker to run the official GitHub MCP server:

  • Image: ghcr.io/github/github-mcp-server
  • Auth: GITHUB_PERSONAL_ACCESS_TOKEN environment variable

Environment Variables

VariableRequiredDescription
GITHUB_PERSONAL_ACCESS_TOKENYesGitHub PAT for authentication
GITHUB_HOSTNoFor GitHub Enterprise (default: github.com)
GITHUB_TOOLSETSNoComma-separated toolsets to enable
GITHUB_READ_ONLYNoSet to 1 for read-only mode

Limiting Toolsets

When using MCP, configure toolsets via environment variables:

# Only repos and issues
GITHUB_TOOLSETS=repos,issues

# Only pull requests and code security
GITHUB_TOOLSETS=pull_requests,code_security

Error Handling

If operations fail:

  1. Verify Docker is running: docker ps
  2. Check GitHub token is set: echo $GITHUB_PERSONAL_ACCESS_TOKEN
  3. Ensure token has required permissions for the operation
  4. Use gh auth status to verify authentication

Related

Memory Protocol (MANDATORY)

Before starting: Read .claude/context/memory/learnings.md

After completing:

  • New pattern -> .claude/context/memory/learnings.md
  • Issue found -> .claude/context/memory/issues.md
  • Decision made -> .claude/context/memory/decisions.md

ASSUME INTERRUPTION: If it's not in memory, it didn't happen.

FAQ

What does the github-mcp skill do?

GitHub API operations - repositories, issues, pull requests, actions, code security, discussions, gists, and more. Use for GitHub-related tasks like managing PRs, issues, searching code, and monitoring workflows.

How do I install github-mcp?

Run npx skills add https://github.com/oimiragieo/agent-studio --skill github-mcp in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/github-mcp/ (personal) or .claude/skills/github-mcp/ (project).

Which AI agents can use github-mcp?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is github-mcp safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains github-mcp?

It is published by oimiragieo in oimiragieo/agent-studio. It has 81 recorded installs.

More from oimiragieo/agent-studio

View all →

pyqt6-ui-development-rules

oimiragieo/agent-studio

PyQt6 desktop GUI development rules -- signal/slot architecture, QSS theming, QThread concurrency, layout management, and cross-platform rendering. Enforces MVC separation and responsive UI patterns.

Frontend & Design1.1K installs

filesystem

oimiragieo/agent-studio

File system operations guidance - read, write, search, and manage files using Claude Code's built-in tools.

729 installs

chrome-browser

oimiragieo/agent-studio

Open the skill to read its SKILL.md instructions.

Productivity & Automation389 installs

slack-notifications

oimiragieo/agent-studio

Open the skill to read its SKILL.md instructions.

Productivity & Automation288 installs

context-compressor

oimiragieo/agent-studio

Open the skill to read its SKILL.md instructions.

268 installs

nodejs-expert

oimiragieo/agent-studio

Open the skill to read its SKILL.md instructions.

Backend & APIs196 installs

Popular ai & agents skills

View category →

google-agents-cli-publish

google/agents-cli

This skill should be used when the user wants to "publish an agent", "publish my ADK agent", "register an agent with Gemini", "publish to Gemini" (formerly Gemini Enterprise), or needs guidance on the agents-cli publish gemini command. Also use when the user wants to "manage agents in Agent Registry", "list/update/delete registered agents", or "register an MCP server". Covers ADK vs A2A registration modes, programmatic and interactive usage, flag reference, auto-detection from deployment metadata, Agent Registry fleet management, and troubleshooting. Part of the agents-cli skills suite. Do NOT use for deployment (use google-agents-cli-deploy).

AI & Agents513.9K installs

google-agents-cli-eval

google/agents-cli

This skill should be used when the user wants to "run an evaluation", "evaluate my agent", "evaluate my ADK agent", "write an eval dataset", "analyze eval failures", "compare eval results", "optimize agent", or needs guidance on the Gemini platform eval methodology and the Quality Flywheel. Covers eval metrics, dataset schema, LLM-as-judge scoring, and common failure causes. Applies to any agents-cli project, whatever framework the agent is written in. Do NOT use for agent API code patterns (ADK: use google-agents-cli-adk-code), deployment (use google-agents-cli-deploy), or project scaffolding (use google-agents-cli-scaffold).

AI & Agents513.5K installs

skill-creator

anthropics/skills

Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.

OfficialAI & Agents416.4K installs

codex-pet

prime-skills/runcomfy-agent-skills

Codex Pet generator on RunComfy. Build a Codex-compatible Codex Pet spritesheet.webp + pet.json from a single reference image, drop it into ${CODEXHOME:-$HOME/.codex}/pets/ / and Codex picks it up as a custom Codex Pet next to the 8 built-ins. This skill produces the exact Codex Pet atlas Codex expects (1536x1872 PNG/WebP, 8 cols x 9 rows, 192x208 cells, 9 animation states — idle, running-right, running-left, waving, jumping, failed, waiting, running, review). Calls OpenAI GPT Image 2 edit ONCE via the local RunComfy CLI as runcomfy run openai/gpt-image-2/edit to produce a canonical Codex Pet pose, then assembles all 9 animation rows programmatically with ImageMagick micro-transforms — no Codex Pro, no $imagegen, no OPENAIAPIKEY required, only RUNCOMFYTOKEN. Triggers on "codex pet", "create codex pet", "make codex pet", "hatch codex pet", "/hatch image", "desktop pet codex", "codex pets", "spritesheet.webp", or any explicit ask to build a custom pet for OpenAI Codex.

AI & Agents402.1K installs

full-output-enforcement

leonxlnx/taste-skill

Overrides default LLM truncation behavior. Enforces complete code generation, bans placeholder patterns, and handles token-limit splits cleanly. Apply to any task requiring exhaustive, unabridged output.

AI & Agents401K installs

executing-plans

obra/superpowers

Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available

AI & Agents245.7K installs