Git (Reference)

Add to your client

Copy the config for your MCP client and paste it into its config file.

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

Before you start

• Python 3.10+ with `uv`/`uvx` (recommended) so you can run `uvx mcp-server-git` directly, OR `pip` to install `mcp-server-git`
• Git installed and a local Git repository to operate on
• Docker is an optional alternative (image `mcp/git`), bind-mounting the repo into the container
• No credentials or auth — it acts on the local repo only

About Git (Reference)

Tools & capabilities (12)

When to use it

• Use it when you want an agent to inspect repo status and diffs before proposing or making changes.
• Use it when you want the model to stage and commit work with proper, descriptive commit messages.
• Use it when reviewing history — querying `git_log` or reading a specific commit with `git_show`.
• Use it when you need scoped, auditable Git operations instead of giving an agent an open shell.
• Use it when managing branches: creating, switching, or listing branches during an automated workflow.

Quick setup

1. 1Ensure Git and Python (with uv) are installed.
2. 2Add the server to your MCP client config, e.g. command `uvx` with args `mcp-server-git --repository /path/to/repo`.
3. 3Alternatively `pip install mcp-server-git` and run `python -m mcp_server_git`, or use the `mcp/git` Docker image with a bind-mounted repo.
4. 4Restart the MCP client so it launches the server.
5. 5Verify by asking the model to run `git_status` on the repository.

Git (Reference) FAQ