Skip to content
MCP server

GitDiagram

Architecture diagrams, explanations and Mermaid source for GitHub repositories, no sign-in

Install
Pricing
Free
Platforms
Web, API, self-hosted
Runs
Remotely
Version
1.0.0
Listing updated
1 day ago

About GitDiagram

GitDiagram is a free MCP server for developer tools. It runs as a hosted remote server, so there is nothing to install locally.

Agents can ask how a repository is structured and get an architecture explanation, components, connections and Mermaid source back, search diagrams that already exist, and fetch explainer videos. The README says the hosted server needs no key or sign-in and covers public repositories.

The broader project turns a GitHub repository into an interactive diagram with clickable components that link to files, PNG export, and about-one-minute narrated explainer videos with MP4 download. Private repositories work in the web app with a GitHub token, and creating new videos is in early access. Swapping hub for diagram in a GitHub URL opens the diagram, and a Markdown version is at gitdiagram.com/owner/repo.md.

The code can be run locally with Bun, Cloudflare R2, Upstash Redis and an OpenAI or OpenRouter key. Plugins exist for Claude Code and Gemini CLI.

Install

Run in a terminal

claude mcp add --transport http gitdiagram https://gitdiagram.com/mcp

Add to Settings → Connectors → Add custom connector

https://gitdiagram.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gitdiagram": {
      "url": "https://gitdiagram.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "gitdiagram": {
      "type": "http",
      "url": "https://gitdiagram.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "gitdiagram": {
      "serverUrl": "https://gitdiagram.com/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "gitdiagram": {
      "type": "http",
      "url": "https://gitdiagram.com/mcp"
    }
  }
}

What it does

Repo architecture
Components, connections and explanation for a repository.
Mermaid source
Returns diagram source for reuse.
Diagram search
Search stored diagrams.
Explainer videos
Narrated one-minute videos with MP4 download.
Keyless access
MCP needs no key or sign-in.
Markdown output
Append .md to a diagram URL.

Good for

  • Ask how an unfamiliar repo is structured
  • Copy Mermaid into docs
  • Watch a short repo explainer
  • Onboard onto a codebase

Pricing

Free

Free to use; self-hostable

Prices change. Check gitdiagram.com before you buy.

GitDiagram FAQ

Does it need an account?

No, the MCP server needs no key or sign-in.

Do private repos work?

In the web app with a GitHub token.

How do I use it from Claude Code?

Run claude mcp add --transport http gitdiagram https://gitdiagram.com/mcp.

Can I self-host it?

Yes, with Bun, Cloudflare R2, Upstash Redis and an OpenAI or OpenRouter key.

Is GitDiagram free?

Yes. GitDiagram is free to use.

How do I add GitDiagram to Claude Code?

Run this command in your terminal: claude mcp add --transport http gitdiagram https://gitdiagram.com/mcp

What are the best alternatives to GitDiagram?

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

Alternatives to GitDiagram

  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