---
title: "GitHub MCP"
---

To use GitHub, you will have to generate a Personal Access Token via your GitHub account, and authenticate with specific permissions.

## Creating a Personal Access Token

1. **Access GitHub Developer Settings**  
   These can be found under **Settings → Developer Settings**.

2. **Generate New Token**  
   Generate a new token with the permissions you want to provide.

3. **Repository Access**  
   For access to specific repositories, select **All Repositories**.

![GitHub Personal Access Token Setup](../Images/github-token-setup.png)

## Required Permissions

In general, you will need to provide **Metadata access** for repositories, and any other actions you may want to carry out using your Agents.

Configure your token with appropriate permissions based on your use case:

- **Metadata**: Required for basic repository access
- **Contents**: For reading and writing files in repositories
- **Issues**: For creating and managing issues
- **Pull requests**: For managing pull requests
- **Actions**: For workflow management
- **Administration**: For repository administration tasks

<Warning>
  Personal Access Token provisioning may be limited by your Organization and may send an approval request to your GitHub organization admin. GitHub does not show this step when you generate the token, but the permissions will not be available until this step is completed.
</Warning>

## Adding GitHub MCP to Airia Platform

![GitHub MCP Platform Configuration](../Images/github-mcp-platform.png)

Once your Personal Access Token is saved and approved:

1. **Select GitHub MCP**  
   Navigate to the Tools library and select **GitHub MCP**.

2. **Provide Authentication**  
   Add the Personal Access Token to the GitHub MCP to add the tools you want to bring in.

3. **Tool Discovery**  
   The platform will automatically discover and configure the available GitHub tools based on your token permissions.

## Using GitHub MCP Tools in Agents

Once configured, your agents can interact with GitHub repositories and perform various operations based on the permissions granted through your Personal Access Token.