Git MCP Server

Git MCP Server

Connect Claude to your Git repositories through the Model Context Protocol.

The Git MCP Server enables Claude to execute git commands, manage branches, create commits, and interact with your version control workflow using natural language.

What Can Claude Do with the Git MCP Server?

The Git MCP Server exposes Git version control operations to Claude through the Model Context Protocol.

Core capabilities:

• Commit Changes — Stage files and create commits with messages
• Branch Management — Create, switch, list, and delete branches
• View History — Read commit logs, diffs, and repository status
• Merge Operations — Merge branches and resolve basic conflicts
• Remote Operations — Push, pull, and fetch from remote repositories (with proper authentication)

Access scope: Claude can execute git commands on repositories you explicitly configure. Operations are limited to the working directory paths you allow.

How to Install the Git MCP Server

Installation requires Git to be installed on your system and configuration of allowed repository paths.

Prerequisites

• Git installed locally — Verify with git --version in your terminal
• Repository access — The MCP Server needs filesystem access to your git repositories

For Claude Code

The official Git server in the Model Context Protocol servers repository is the Python package mcp-server-git, so the safest Claude Code setup uses uvx and the maintained Python distribution.

claude mcp add git uvx mcp-server-git --repository /path/to/repo

Add more --repository flags if you want Claude to work across multiple local repositories.

For Claude Desktop

Add the server to your claude_desktop_config.json file with allowed repository paths:

Configuration file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Typical configuration structure:

{
  "mcpServers": {
    "git": {
      "command": "uvx",
      "args": [
        "mcp-server-git",
        "--repository",
        "/Users/username/projects/my-repo"
      ]
    }
  }
}

Configuration notes:

• Each repository path should be specified as an argument
• Use absolute paths to git repositories
• Multiple repositories can be specified as separate arguments
• The path should point to the repository root (where .git folder exists)

This matches the official MCP servers distribution, where the Git server ships as mcp-server-git and is typically launched with uvx.

Restart Claude Desktop after saving the configuration file.

Git MCP Server Configuration & Auth

The Git MCP Server requires proper configuration for local and remote operations.

Repository access:

The MCP Server operates on git repositories in directories you explicitly configure. It cannot access repositories outside these allowed paths.

Authentication for remote operations:

Remote git operations (push, pull, fetch) require authentication:

1. SSH Keys (Recommended)

• Configure SSH keys for GitHub, GitLab, or other remote hosts
• Ensure your SSH agent is running with loaded keys
• Test with ssh -T git@github.com

1. HTTPS with Credential Storage

• Use git credential helpers to cache credentials
• Configure with git config --global credential.helper store
• First push/pull will prompt for credentials

1. Personal Access Tokens

• For HTTPS remotes, use tokens instead of passwords
• GitHub: Settings → Developer settings → Personal access tokens
• GitLab: User Settings → Access Tokens

Git configuration:

The MCP Server uses your existing git configuration:

# Configure user identity (required for commits)
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

# Configure default branch name
git config --global init.defaultBranch main

Security considerations:

• The MCP Server can execute any git command on allowed repositories
• Write operations (commit, push, branch deletion) should be used carefully
• Review changes before allowing Claude to push to remote repositories
• Consider using separate branches for Claude-generated commits

Git MCP Use Cases & Workflow Examples

Example workflows that become possible with the Git MCP Server.

Check Repository Status

Example prompt:

> "Show me the current status of my repository. What files have changed?"

Claude can run git status and report uncommitted changes.

Create Commits

Example prompt:

> "Stage all modified files and commit them with the message 'Update documentation'."

Claude can execute git add and git commit operations.

Branch Management

Example prompt:

> "Create a new branch called 'feature/new-login' and switch to it."

Claude can create and switch branches using git checkout -b or git switch -c.

View Commit History

Example prompt:

> "Show me the last 5 commits on this branch."

Claude can run git log with formatting options.

Review Changes

Example prompt:

> "Show me the diff of uncommitted changes in the src directory."

Claude can execute git diff to display file changes.

Merge Branches

Example prompt:

> "Merge the feature/new-login branch into main."

Claude can perform branch merges (for simple, non-conflicting merges).

Push to Remote

Example prompt:

> "Push the current branch to origin."

Claude can execute git push if remote authentication is configured.

Sync with Remote

Example prompt:

> "Pull the latest changes from origin main."

Claude can run git pull to update from remote repositories.

Note: These are example use cases. Complex merge conflicts, rebase operations, and advanced git workflows may require manual intervention. Remote operations require proper authentication setup.

Use Git MCP in Verdent

Verdent provides streamlined Git integration with repository management. This is Verdent's platform-level integration flow, not the default setup path from Git MCP implementations.

Version control operations work within Verdent's project environment with simplified branch management and commit workflows.

Explore Verdent Git Features