๐ GitHub MCP Server for Claude Desktop
Supercharge your Claude Desktop with seamless GitHub integration!
This MCP server connects Claude Desktop directly to your GitHub repos and git commands, letting you interact with your code and repositories through natural conversation.
โจ Features
- ๐
git-clone
- Clone any repository with a simple request
- ๐
git-status
- Check what's happening in your git repos
- ๐
github-list-repos
- Browse your GitHub repositories
- ๐
github-repo-info
- Get detailed information about any repository
- ๐
git-commit
- Commit changes to your repositories
- ๐
git-push
- Push your commits to GitHub
- ๐
github-create-repo
- Create new GitHub repositories
๐ Quick Start
Clone this repo:
git clone https://github.com/shibdad/github-mcp-server.git
cd github-mcp-server
Install dependencies:
npm install
Make it executable:
chmod +x start.sh index.js
Add your GitHub token (for private repos and API access):
echo "your-github-token" > .github_token
Hook it up to Claude Desktop:
Edit Claude's config file:
* macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
* Windows: `%APPDATA%\Claude\claude_desktop_config.json`
Add this to your config:
{
"mcpServers": {
"github": {
"command": "/bin/sh",
"args": ["-c", "/path/to/github-mcp-server/start.sh"]
}
}
}
- Restart Claude and you're good to go!
๐ฌ Try These Prompts
Once connected, ask Claude things like:
- "Clone the tensorflow/models repository to my downloads folder"
- "What's the git status of my project directory?"
- "Show me a list of my GitHub repositories"
- "Get details about the microsoft/vscode repository"
- "Commit my changes with the message 'Update documentation'"
- "Push my commits to GitHub"
- "Create a new repository called 'my-awesome-project'"
๐ง Requirements
- Node.js 16+
- Git command-line tools
- Claude Desktop
- GitHub Personal Access Token (for API access)
๐ GitHub Token Options
Need to access private repos? Add your token any of these ways:
Create a .github_token
file in the project folder
Set the GITHUB_TOKEN
environment variable
Add it directly in Claude's config:
{
"mcpServers": {
"github": {
"command": "/bin/sh",
"args": ["-c", "/path/to/github-mcp-server/start.sh"],
"env": {
"GITHUB_TOKEN": "your-github-token"
}
}
}
}
๐โโ๏ธ Contributing
Found a bug? Want to add a feature? PRs welcome!
๐ License
MIT