# GitFlic MCP

> GitFlic MCP is an open-source MCP server for developer tools. 78 tools for GitFlic merge requests, issues, releases, packages and CI. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://cli-gitflic.ru/mcp-server.html
- **Repository:** https://github.com/zhimbura/gitflic-cli/tree/HEAD/mcp-server
- **MCP Registry name:** io.github.zhimbura/gitflic-cli-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

This server wraps the gitflic command-line client as typed tools, one tool per subcommand, so an agent can work with a GitFlic repository host. It runs locally over stdio, reads a GitFlic access token from the environment and can pick up the project from the git remote.

Loading all 78 tools costs about 6,000 tokens of context, so the server can be narrowed. Settings choose tool groups or an explicit allowlist, expose only read-only tools, drop destructive delete tools, or exclude named ones. A read-only setting also limits an allowlist, so a write tool cannot slip in.

The documentation is in Russian. Install it with npx or globally from npm, or run it from source.

## Features

- **78 CLI-mapped tools:** Each tool maps to one gitflic subcommand.
- **Read-only mode:** Expose no mutating tools.
- **Tool groups:** Keep only chosen groups to save context.
- **No-destructive switch:** Remove deletion tools.
- **Project resolver:** Detects the project from the git remote.

## Good for

- Review merge requests from an agent
- Triage issues on GitFlic
- Cut a release
- Check CI pipelines and packages

## Install

### Claude Code (Terminal)

```sh
claude mcp add gitflic-cli-mcp --env GITFLIC_TOKEN='<GITFLIC_TOKEN>' -- npx -y gitflic-cli-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gitflic-cli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gitflic-cli-mcp"
      ],
      "env": {
        "GITFLIC_TOKEN": "<GITFLIC_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gitflic-cli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gitflic-cli-mcp"
      ],
      "env": {
        "GITFLIC_TOKEN": "<GITFLIC_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "gitflic-cli-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "gitflic-cli-mcp"
      ],
      "env": {
        "GITFLIC_TOKEN": "<GITFLIC_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gitflic-cli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gitflic-cli-mcp"
      ],
      "env": {
        "GITFLIC_TOKEN": "<GITFLIC_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gitflic-cli-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "gitflic-cli-mcp"
      ],
      "env": {
        "GITFLIC_TOKEN": "<GITFLIC_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Which clients are shown?

Claude Code and Cursor.

### How do I authenticate?

A GitFlic token in GITFLIC_TOKEN, or the OS keychain via the CLI.

### How can I limit tools?

Environment variables or flags for groups, allowlists, read-only and exclusions.

### Is GitFlic MCP free?

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

### How do I add GitFlic MCP to Claude Code?

Run this command in your terminal: claude mcp add gitflic-cli-mcp --env GITFLIC_TOKEN='<GITFLIC_TOKEN>' -- npx -y gitflic-cli-mcp

### What are the best alternatives to GitFlic MCP?

The closest alternatives to GitFlic MCP 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/gitflic-mcp
