Provides tools for local git operations including creating branches, committing with conventional commit format, pushing and pulling from remotes, checking status, and syncing with main branch.
Integrates with GitHub for authenticated remote operations such as push and pull, and supports branch naming conventions based on GitHub issues.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Git MCP Server create branch for issue #42"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Python MCP (Model Context Protocol) server for local git operations, providing native tool integration with Claude Code and other MCP clients.
6 Git Tools: Commit, branch, push, pull, status, and sync operations
Native MCP Integration: Works seamlessly with Claude Code
Conventional Commits: Enforced commit message format with type prefixes
Branch Naming: Enforced conventions (issue-N-description, feature-*, etc.)
Token Authentication: Automatic GitHub token injection for remote operations
Related MCP server: Git Workflow MCP Server
pip install git-mcp-server
# or with uv
uvx git-mcp-servergit clone https://github.com/rriesco/git-mcp-server.git
cd git-mcp-server
uv syncVariable | Required | Description |
| For push/pull | GitHub Personal Access Token for authenticated git operations |
Add to your MCP configuration (~/.config/claude-code/mcp-config.json):
{
"mcpServers": {
"git-manager": {
"type": "stdio",
"command": "uvx",
"args": ["git-mcp-server"],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}Tool | Description |
| Create and checkout a new branch with naming conventions |
| Create conventional commit with Claude attribution |
| Push commits to remote with upstream tracking |
| Pull commits from remote |
| Get current branch, tracking info, and file changes |
| Sync current branch with main (merge or rebase) |
result = git_create_branch(
issue_number=42,
description="add-feature-x"
)
# Creates: issue-42-add-feature-xresult = git_commit(
type="feat",
message="implement user authentication"
)
# Creates: feat: implement user authentication
#
# Co-Authored-By: Claude <noreply@anthropic.com>result = git_status()
# Returns: {branch, tracking, ahead, behind, staged, modified, untracked, clean}result = git_sync_with_main(
main_branch="main",
strategy="merge" # or "rebase"
)The git_commit tool enforces conventional commit types:
Type | Description |
| New feature |
| Bug fix |
| Documentation only |
| Code style (formatting, semicolons, etc.) |
| Code refactoring |
| Performance improvement |
| Adding or fixing tests |
| Build system or dependencies |
| CI/CD configuration |
| Maintenance tasks |
| Revert previous commit |
The git_create_branch tool enforces naming conventions:
issue-<N>-<description> - For GitHub issues
feature-<description> - For features without issues
fix-<description> - For bug fixes
refactor-<description> - For refactoring
Python >= 3.10
uv (recommended) or pip
Git
git clone https://github.com/rriesco/git-mcp-server.git
cd git-mcp-server
uv sync# Unit tests only (fast)
uv run pytest -m "not integration" -v
# Integration tests (creates real git repos in temp directories)
uv run pytest -m integration -v
# All tests with coverage
uv run pytest --cov=git_mcp_server --cov-report=term-missinguv run mypy src/git_mcp_server --strictClaude Code / MCP Client
|
| MCP Protocol (stdio)
v
┌─────────────────────────────┐
│ Python FastMCP Server │
│ - Tool Registry │
│ - GitPython Client │
│ - Error Handling │
│ - Type Validation │
└─────────────┬───────────────┘
|
| GitPython
v
Local Git Repogit-mcp-server/
├── src/git_mcp_server/
│ ├── server.py # Server entry point
│ ├── tools/
│ │ ├── branch.py # Branch operations
│ │ ├── commit.py # Commit operations
│ │ ├── remote.py # Push/pull operations
│ │ ├── status.py # Status queries
│ │ └── sync.py # Sync with main
│ └── utils/
│ ├── git_client.py # Singleton Repo instance
│ └── errors.py # Structured error handling
└── tests/
├── test_*.py # Unit tests
└── integration/ # Integration testsMIT License - see LICENSE for details.
Contributions are welcome! Please read the contributing guidelines before submitting PRs.
Fork the repository
Create a feature branch
Make your changes with tests
Submit a pull request
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Git-backed platform for skills, tools, and context for AI agents
Edit your Overleaf LaTeX projects from Claude and ChatGPT; every change is a real Git commit.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/rriesco/git-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server