Skip to content
MCP server

GitFlic MCP

78 tools for GitFlic merge requests, issues, releases, packages and CI

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.5.1
Listing updated
3 days ago

About GitFlic MCP

GitFlic MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • GITFLIC_TOKENGitFlic access token (Profile -> API tokens on gitflic.ru).Required
  • GITFLIC_MCP_READONLYSet to 1 to expose only read-only tools.

What it does

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

Pricing

Open source

Prices change. Check cli-gitflic.ru before you buy.

GitFlic MCP 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 to GitFlic MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools