
GitDiagram
Architecture diagrams, explanations and Mermaid source for GitHub repositories, no sign-in
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://gitdiagram.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"gitdiagram": {
"url": "https://gitdiagram.com/mcp"
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools