Git Mcp

What is Git MCP?

Git MCP is an MCP server that manages common Git operations on local repositories. It exposes a set of tools for listing repositories, inspecting tags and commits, creating and pushing tags, and syncing the main branch.

How to use Git MCP?

Install via Smithery (npx -y @smithery/cli install @kjozsa/git-mcp --client claude) or manually with uvx install git-mcp. Configure the GIT_REPOS_PATH environment variable pointing to a directory containing Git repositories, then add the server to your MCP client configuration.

Key features of Git MCP

• List all Git repositories in a configured directory.
• Retrieve the latest Git tag from a repository.
• List commits since the last tag (with optional limit).
• Create annotated or lightweight Git tags.
• Push an existing tag to the default remote.
• Checkout and pull from all remotes (main/master branch).

Use cases of Git MCP

• Automate version tagging and release preparation across multiple repos.
• Quickly inspect recent commits and tags for changelog generation.
• Sync the main branch of multiple repositories in one call.
• Integrate Git operations into AI‑assisted development workflows.

FAQ from Git MCP

What dependencies does Git MCP require?

The server runs on Python and is installed via uvx (from the uv package manager). A local Git installation is also required for the underlying operations.

Where are my Git repositories stored?

Repositories must be placed under the directory specified by the GIT_REPOS_PATH environment variable. Only repositories inside that path are accessible.

What Git operations can Git MCP perform?

It can list repositories, get the last tag, list commits since that tag, create a tag (lightweight or annotated), push a tag to the default remote, and checkout/pull the main or master branch.

How do I troubleshoot common issues?

If a repository is not found, verify that GIT_REPOS_PATH is set correctly and the repository exists. If no tags are returned, the repository simply has no tags yet.