GitHub MCP Server

What is GitHub MCP Server?

A Model Context Protocol (MCP) server that provides GitHub integration through a set of tools for repository management, file operations, and commit handling. It enables developers and AI assistants to interact with GitHub repositories programmatically.

How to use GitHub MCP Server?

Install the package via npm, then add the server to your MCP settings file with the required environment variables (GITHUB_TOKEN_<N>, GITHUB_OWNER_<N>, and optionally DEFAULT_OWNER). Once configured, tools such as create_repository, push_file, pull_file, and create_commit are available for use through an MCP client.

Key features of GitHub MCP Server

• Account management (list and select multiple GitHub accounts)
• Repository creation, cloning, and renaming
• File push, pull, and bidirectional directory sync
• Commit creation and listing with filters
• Repository comparison and diffing
• Supports multiple GitHub accounts via numbered environment variables

Use cases of GitHub MCP Server

• Automate repository creation and renaming in CI/CD pipelines
• Push local files to a GitHub repository with a commit message
• Pull files from a repository for local development or analysis
• Sync entire directories between a local folder and a remote repository
• List and filter commits for auditing or release tracking

FAQ from GitHub MCP Server

What are the runtime dependencies?

The server requires Node.js and npm for installation and execution.

How do I authenticate with GitHub?

Set the GITHUB_TOKEN_<N> and GITHUB_OWNER_<N> environment variables, where <N> is a number starting from 1. Use a GitHub personal access token and the corresponding username.

Can I use multiple GitHub accounts?

Yes. Configure multiple accounts by incrementing the number in the environment variable names (e.g., GITHUB_TOKEN_1, GITHUB_TOKEN_2). Use list_accounts and select_account to switch between them.

What is the DEFAULT_OWNER environment variable for?

It sets the default GitHub account (owner) to use when a tool call does not specify an owner explicitly.