Git MCP Server

Name: Git MCP Server
Author: cyanheads

cyanheads

Get started Repository Website & docs

Clone, commit, diff, branch, merge, rebase, stash, tag and manage worktrees in local git repositories.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add git --env MCP_TRANSPORT_TYPE='<MCP_TRANSPORT_TYPE>' --env MCP_LOG_LEVEL='<MCP_LOG_LEVEL>' --env GIT_BASE_DIR='<GIT_BASE_DIR>' --env LOGS_DIR='<LOGS_DIR>' --env GIT_USERNAME='<GIT_USERNAME>' --env GIT_EMAIL='<GIT_EMAIL>' --env GIT_SIGN_COMMITS='<GIT_SIGN_COMMITS>' --env GIT_DEFAULT_PATH='<GIT_DEFAULT_PATH>' -- npx -y @cyanheads/git-mcp-server

~/.codex/config.toml

[mcp_servers.git]
command = "npx"
args = ["-y", "@cyanheads/git-mcp-server"]
env = { MCP_TRANSPORT_TYPE = "<MCP_TRANSPORT_TYPE>", MCP_LOG_LEVEL = "<MCP_LOG_LEVEL>", GIT_BASE_DIR = "<GIT_BASE_DIR>", LOGS_DIR = "<LOGS_DIR>", GIT_USERNAME = "<GIT_USERNAME>", GIT_EMAIL = "<GIT_EMAIL>", GIT_SIGN_COMMITS = "<GIT_SIGN_COMMITS>", GIT_DEFAULT_PATH = "<GIT_DEFAULT_PATH>" }

# codex mcp add git --env MCP_TRANSPORT_TYPE='<MCP_TRANSPORT_TYPE>' --env MCP_LOG_LEVEL='<MCP_LOG_LEVEL>' --env GIT_BASE_DIR='<GIT_BASE_DIR>' --env LOGS_DIR='<LOGS_DIR>' --env GIT_USERNAME='<GIT_USERNAME>' --env GIT_EMAIL='<GIT_EMAIL>' --env GIT_SIGN_COMMITS='<GIT_SIGN_COMMITS>' --env GIT_DEFAULT_PATH='<GIT_DEFAULT_PATH>' -- npx -y @cyanheads/git-mcp-server

~/.cursor/mcp.json

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/git-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "GIT_BASE_DIR": "<GIT_BASE_DIR>",
        "LOGS_DIR": "<LOGS_DIR>",
        "GIT_USERNAME": "<GIT_USERNAME>",
        "GIT_EMAIL": "<GIT_EMAIL>",
        "GIT_SIGN_COMMITS": "<GIT_SIGN_COMMITS>",
        "GIT_DEFAULT_PATH": "<GIT_DEFAULT_PATH>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "git": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/git-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "GIT_BASE_DIR": "<GIT_BASE_DIR>",
        "LOGS_DIR": "<LOGS_DIR>",
        "GIT_USERNAME": "<GIT_USERNAME>",
        "GIT_EMAIL": "<GIT_EMAIL>",
        "GIT_SIGN_COMMITS": "<GIT_SIGN_COMMITS>",
        "GIT_DEFAULT_PATH": "<GIT_DEFAULT_PATH>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/git-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "GIT_BASE_DIR": "<GIT_BASE_DIR>",
        "LOGS_DIR": "<LOGS_DIR>",
        "GIT_USERNAME": "<GIT_USERNAME>",
        "GIT_EMAIL": "<GIT_EMAIL>",
        "GIT_SIGN_COMMITS": "<GIT_SIGN_COMMITS>",
        "GIT_DEFAULT_PATH": "<GIT_DEFAULT_PATH>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/git-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "GIT_BASE_DIR": "<GIT_BASE_DIR>",
        "LOGS_DIR": "<LOGS_DIR>",
        "GIT_USERNAME": "<GIT_USERNAME>",
        "GIT_EMAIL": "<GIT_EMAIL>",
        "GIT_SIGN_COMMITS": "<GIT_SIGN_COMMITS>",
        "GIT_DEFAULT_PATH": "<GIT_DEFAULT_PATH>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "git": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/git-mcp-server"
      ],
      "env": {
        "MCP_TRANSPORT_TYPE": "<MCP_TRANSPORT_TYPE>",
        "MCP_LOG_LEVEL": "<MCP_LOG_LEVEL>",
        "GIT_BASE_DIR": "<GIT_BASE_DIR>",
        "LOGS_DIR": "<LOGS_DIR>",
        "GIT_USERNAME": "<GIT_USERNAME>",
        "GIT_EMAIL": "<GIT_EMAIL>",
        "GIT_SIGN_COMMITS": "<GIT_SIGN_COMMITS>",
        "GIT_DEFAULT_PATH": "<GIT_DEFAULT_PATH>"
      }
    }
  }
}

Environment variables

MCP_TRANSPORT_TYPE
MCP_LOG_LEVEL
GIT_BASE_DIR
LOGS_DIR
GIT_USERNAME
GIT_EMAIL
GIT_SIGN_COMMITS
GIT_DEFAULT_PATH

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related