Skip to main content
GitHub is the world’s leading code hosting platform for version control and collaboration. The GitHub MCP server lets you manage repositories, issues, pull requests, and projects using natural language.

​
What Can It Do?

  • Create and manage repositories and branches on demand
  • Find and filter issues, PRs, and commits for reporting
  • Organize projects with fields and items
  • Automate releases and collaborator management

​
Where to Use It

Add GitHub as a tool to any agent. The agent can then interact with your repositories conversationally, choosing the right actions based on context. To add an MCP tool to your agent:
  1. Open your agent’s configuration
  2. Click Add tools → Connect an app with MCP
  3. Search for the integration and select it
  4. Authenticate with your account
You can control which tools your agent has access to. After adding an integration, click on it to enable or disable specific tools based on what your agent needs.

​
In Workflows (Via Agent Node)

For automated pipelines, use an Agent Node with GitHub tools. This gives you the flexibility of an agent within a deterministic workflow.

​
As a Custom MCP Node

You can also create a standalone MCP node for a specific action. This generates a reusable node that performs one task, useful when you need the same operation repeatedly in workflows.
To create a custom MCP node:
  1. Go to your node library and search for the integration
  2. Click Create a node with AI
  3. Describe the specific action you want (e.g., “List open issues in my repo”)
  4. Test the node and save it for reuse
Custom MCP nodes are single-purpose by design. For tasks that require multiple steps or dynamic decision-making, use an agent instead.

​
Available Tools

ToolDescription
Create/List/Search RepositoriesManage repositories
Get ContentsRetrieve file or directory contents
List/Get CommitsAccess commit history
List/Search IssuesFind and filter issues
Create/Update IssueManage issues
Add Comment To IssueComment on issues
List/Create BranchesManage branches
List/Get/Create Pull RequestsManage PRs
List/Get ProjectsAccess project boards
List/Create/Update/Delete Project FieldsManage project fields
List/Add/Update/Delete Project ItemsManage project items
List/Get Tags and ReleasesAccess releases
List/Add/Remove CollaboratorsManage access
List Labels, Milestones, TeamsOrganization tools
List Deployments and WorkflowsCI/CD access
Search CodeSearch across repositories

​
Example Prompts

Use these with your agent or in the Agent Node: Search repositories: 
Find repositories about "LLM chatbot" with more than 5000 stars
Manage issues: 
Create an issue in octocat/Hello-World titled "Bug: login fails"
List pull requests: 
Show me all open PRs in facebook/react
Get commit details: 
Get the details of the latest commit in my repo
Search code: 
Search for "def get_queryset" in the Django repository

​
Troubleshooting

IssueSolution
Agent not finding the right dataUse specific repository names in owner/repo format
Action not completingCheck that you’ve authenticated and have permissions for the repository
Unexpected resultsThe agent may chain multiple tools (e.g., finding a repo first, then listing issues). Review the agent’s reasoning to understand its approach.
Tool not availableVerify the tool is enabled in your agent’s MCP configuration
Agents are smart enough to chain multiple API calls together. For example, asking “Create an issue in the marketing repo” will find the repository first, then create the issue. If results seem off, check the agent’s step-by-step reasoning.

​
Need Help?

Use this integration directly in Claude or Cursor. Connect remotely via the GitHub MCP server using your Gumloop credentials.