---
title: "Git MCP reference server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/git/
description: "Inspect local Git history and diffs, then stage, commit, or switch branches through explicit tools."
---

# Git MCP reference server: review, setup & limitations · Undominated.ai

> Inspect local Git history and diffs, then stage, commit, or switch branches through explicit tools.

[← Explore all mcp servers](/mcp-servers/)

REPOSITORY COLLABORATION / Model Context Protocol steering group

# Git MCP reference server

Inspect local Git history and diffs, then stage, commit, or switch branches through explicit tools.

 [See setup guidance ↓](#setup)[Original source ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/git/README.md)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 6 linked sources
 Publisher Model Context Protocol steering group
 Licence [Apache-2.0 / MIT transition; documentation CC-BY-4.0 ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/LICENSE)
 Revision bbb701e7ac1e
 [Read what was—and wasn’t—checked ↓](#review)

“Tools to read, search, and manipulate Git repositories.”

 [Model Context Protocol steering group · upstream description ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/README.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Works with existing local Git repositories without requiring a GitHub or GitLab account.
- Separates status, diff and log reads from index, commit and branch operations.

### A good fit for

 - Review a working tree and commit history.
- Experiment with explicitly approved local Git mutations.

### Weigh up before choosing

 - The publisher describes this as an educational reference implementation, not a production-ready service.
- Git add, commit, reset, branch creation and checkout are available; give the client only repositories it may modify.
- The README calls this early development, and the Python package currently targets the older MCP SDK API.
- The README says --repository walks up to the enclosing repository root, so a subdirectory path allows tool calls anywhere in that repository.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - src/git/README.md and pyproject.toml.
- src/git/src/mcp_server_git/server.py: repository path validation, handler dispatch and stdio startup.
- Repository README and current licence transition.
- src/git/LICENSE at the same commit.

### Our findings

 - Tool calls validate repo_path against the configured repository; configure --repository rather than assuming an omitted argument establishes a sandbox.
- The exposed reset operation unstages changes. No push or pull tool is listed in the inspected implementation.
- server.py at this commit defines twelve tools in its GitTools enum: git_status, git_diff_unstaged, git_diff_staged, git_diff, git_commit, git_add, git_reset, git_log, git_create_branch, git_checkout, git_show and git_branch.
- validate_repo_path returns without any check when no repository is configured. git_commit now refuses when nothing is staged, except during a merge.
- src/git/LICENSE at this commit is the MIT licence (Copyright (c) 2024 Anthropic, PBC.) and pyproject.toml declares MIT. The root LICENSE says MIT contributions without relicensing consent remain MIT, so the two agree.
- The README’s Claude Desktop uvx block is a fragment without outer braces. The configuration example now reproduces it as text instead of adding braces.

### Not established by this review

 - Server launch, authenticated tool calls, and release-to-source parity were not tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/git/README.md)

DOCUMENTED COMMAND

 pip install mcp-server-git Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - Install the published Python package using the shown pip command or follow the documented uvx configuration.
- Configure command uvx with mcp-server-git, --repository and the intended local repository path in your client.
- Review mutation requests before staging, committing or changing branches.

### Before you start

 - Python tooling (pip or uv).
- Git, an existing local repository, and filesystem permission to it.

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 "mcpServers": {
 "git": {
 "command": "uvx",
 "args": ["mcp-server-git", "--repository", "path/to/git/repo"]
 }
} Copy configuration ↗

### Compatibility

Claude Desktop · VS Code · stdio clients

### Implementation

Python

### Transports

stdio

### Local process

 - Reads local diffs, status, branches, commit metadata and file changes.
- Can modify the index, create commits and branches, and check out branches within the configured repository scope.

### Cost model

Runs on your machine; hosting and any connected model client are separate costs.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Git MCP reference server setup and scope ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/git/README.md) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/git/README.md Supports: summary, upstreamDescription, whySelected, bestFor, limitations, install, access, compatibility, transports, review, configExample, --repository resolves to the repository root
- [MCP steering-group reference implementation scope ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/README.md) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/README.md Supports: publisher, upstreamDescription, limitations, review
- [Current MCP repository licence transition ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/LICENSE) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/LICENSE Supports: license, review
- [Git server Python package ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/git/pyproject.toml) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/git/pyproject.toml Supports: language, install
- [Git tool handlers and path validation ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/git/src/mcp_server_git/server.py) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/git/src/mcp_server_git/server.py Supports: review, access, transports, Tool list (GitTools enum), validate_repo_path, git_commit refuses an empty commit
- [Git server package licence ↗](https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/git/LICENSE) Checked 2026-10-13 https://raw.githubusercontent.com/modelcontextprotocol/servers/bbb701e7ac1e57f3edd1c2836b94c5457eaf7b9c/src/git/LICENSE Supports: license, MIT, Copyright (c) 2024 Anthropic, PBC.

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### GitHub MCP Server ↗ Connects an assistant to repository, issue, pull-request and workflow operations with selectable toolsets and account permissions.](/mcp-servers/github/)[### GitKraken MCP Server ↗ GitKraken's official MCP server connects assistants to git history, branches, issues, pull requests and multi-repo workflows across GitHub, GitLab, Azure DevOps, Bitbucket and Jira. Ships inside the gk CLI (npm @gitkraken/gk), installs via GitLens, and is packaged for the Docker MCP Catalog.](/mcp-servers/gitkraken/)[### Gitee MCP Server ↗ Manage Gitee repositories, issues, pull requests and notifications with selectable tool groups.](/mcp-servers/gitee/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
