# Fluxgit MCP Server

> Fluxgit MCP Server is an open-source MCP server for developer tools. Rust Git MCP server with 25 read-only tools and human-approved write proposals. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://fluxgit.com/features/mcp-agent-git/
- **Repository:** https://github.com/fluxgit-hq/fluxgit-mcp-server
- **MCP Registry name:** io.github.fluxgit-hq/fluxgit-mcp-server
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

The server splits Git work into inspection and consent. It exposes 25 read-only tools, 15 of which work with plain git and need no app, plus 13 operation tools: twelve submit proposals and one cancels a pending one. It never performs a Git write itself. A proposal goes to the FluxGit desktop app, which shows a preview, risk and recovery context, and the operation runs only after a person approves. Approvals and results are logged locally, with Ed25519 signing when enabled.

Useful reads include repo.brief for one-call situational awareness, repo.scope for monorepo subtrees, conflict.read for active conflicts as structured data, worktree.list, diff.semantic with documented fallbacks, fleet.radar and fleet.digest across repositories, and a reflog and restore-point timeline. Tools needing the app return an explicit error code instead of a guess.

The maintainers state a limit: if the host also gives the agent a shell, it can run git directly, which FluxGit can only record through a hook. The loop is beta; interactive rebase is not yet supported and results are polled. Licensed Apache-2.0.

## Features

- **Situational brief:** repo.brief replaces several raw git calls in one budgeted answer.
- **Structured conflicts:** conflict.read returns base, ours, theirs and marker regions.
- **Propose-approve writes:** Writes become proposals a person approves in the app.
- **Multi-repo awareness:** fleet.radar and fleet.digest summarise many repositories.
- **Restore points:** Safety tools expose timelines and restore points.
- **Signed audit log:** Records proposals and results locally.

## Good for

- Have an agent explain branch state and recent history
- Read an active merge conflict as structured data
- Let an agent propose a merge or push for human approval
- Summarise what changed across several repositories
- Predict merge outcomes before running them

## Install

### Claude Code (Terminal)

```sh
claude mcp add fluxgit-mcp-server -- npx -y fluxgit-mcp-sidecar
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "fluxgit-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "fluxgit-mcp-sidecar"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "fluxgit-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "fluxgit-mcp-sidecar"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "fluxgit-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fluxgit-mcp-sidecar"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "fluxgit-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "fluxgit-mcp-sidecar"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "fluxgit-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "fluxgit-mcp-sidecar"
      ]
    }
  }
}
```

## Tools

- `repo.brief`: One-call situational awareness for a repository.
- `repo.scope`: Scopes one subtree of a monorepo.
- `repo.status`: Working tree and current branch status.
- `repo.refs`: Branches, tags, remotes and stashes.
- `repo.branchStack`: Current branch versus upstream and base.
- `repo.history`: Paginated commit history.
- `repo.reflog`: Movement timeline with recovery hints.
- `repo.conflictPreflight`: Predict merge or rebase outcome.
- `conflict.read`: Active conflict as structured data.
- `commit.details`: Single commit metadata and changed files.
- `worktree.changes`: Per-path working tree changes.
- `worktree.list`: Lists worktrees.
- `submodule.status`: Submodule list and state.
- `diff.text`: Standard text patch.
- `diff.semantic`: Semantic diff explanation.
- `fleet.radar`: Multi-repo attention queue.
- `fleet.digest`: What changed across repositories since a time.

## FAQ

### Can the agent write to Git through it?

No. It can only submit proposals, which run after a person approves in the FluxGit app.

### Does it work without the app?

Standard inspection tools do; app-dependent tools return an explicit hint.

### What are its limits?

If the host gives the agent a shell, git can still be run directly; interactive rebase is not yet supported.

### What is the licence?

Apache-2.0.

### Is Fluxgit MCP Server free?

Yes. Fluxgit MCP Server is open source, so you can use and self-host it for free.

### How do I add Fluxgit MCP Server to Claude Code?

Run this command in your terminal: claude mcp add fluxgit-mcp-server -- npx -y fluxgit-mcp-sidecar

### What are the best alternatives to Fluxgit MCP Server?

The closest alternatives to Fluxgit MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/fluxgit-mcp-server
