# GitDiagram

> GitDiagram is a free MCP server for developer tools. Architecture diagrams, explanations and Mermaid source for GitHub repositories, no sign-in. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, API, self-hosted
- **Website:** https://gitdiagram.com
- **Repository:** https://github.com/ahmedkhaleel2004/gitdiagram
- **MCP Registry name:** com.gitdiagram/gitdiagram
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gitdiagram.com/mcp
```

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

```json
{
  "mcpServers": {
    "gitdiagram": {
      "url": "https://gitdiagram.com/mcp"
    }
  }
}
```

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

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

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

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

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

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

## 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

- [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/gitdiagram
