GitDiagram MCP Server: Setup for Claude, Cursor and Other Apps
Lets Claude, Cursor and other assistants explain how any public GitHub repository is built, with components, connections and Mermaid diagram source.
GitDiagram is a hosted server from the GitDiagram site. Add its address to your assistant and ask how a repository is structured. You get an explanation, the main components with their source paths, how they connect, and Mermaid source, plus a link to an interactive diagram.
It needs no key or sign-in and only works on public repositories. All three tools only read.
Good for
- Developers reading an unfamiliar open-source codebase
- Engineers who need a quick architecture overview before a code review
- Writers and teachers who want a diagram or explainer video of a project
Works in
14 should work
Tap an app to see how to set it up and any known problems.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Supports hosted MCP servers.
Install GitDiagram MCP
Claude Code
- 1
Copy this prompt.
Add the GitDiagram MCP server to Claude Code. Run this command: claude mcp add --transport http gitdiagram https://gitdiagram.com/mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Built from the package data we hold. Not yet tested by us.
Tools
Gets a repo's architecture diagram
Returns a written explanation of how a public GitHub repository is organized, its main components with their paths, how they connect, and Mermaid source. If no diagram exists yet it returns a link that makes one in a browser.
Try: “How is fastapi/fastapi structured?”
Network ·
get_repository_diagramFinds repos that already have diagrams
Searches the stored diagrams by owner or repository name and returns up to 10 matches, most-starred first. It searches names only, not code.
Try: “Which Microsoft repos have architecture diagrams?”
Network ·
find_repository_diagramsGets a repo's explainer video
Returns the link, title, length and narration transcript of the narrated video for a public repository, if one was made. It never makes a video.
Try: “Is there an explainer video for vercel/next.js?”
Network ·
get_explainer_video
From the official docs
Permissions
low risk · 2 things to watch
Low risk
The tools only read diagrams that GitDiagram already made, so nothing in your accounts changes. Your requests go to gitdiagram.com, so avoid asking about repositories whose names you want kept private.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Repository names go to a third party
The names you ask about are sent to gitdiagram.com. Do not use it for repositories whose names are private. github.com
It covers public repositories only
The tool description says public repositories only. The web app has a separate private repo option that the server does not expose. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | All tools are marked read-only in the server source, so no switch is needed. |
|---|---|
| Talks to | gitdiagram.com |
| Sign-in and keys | No key or sign-in is needed. |
Questions
Is this the official GitDiagram server?
Yes. It lives in the GitDiagram repository and runs on gitdiagram.com, so it comes from the same project as the diagram site.
What is the GitDiagram MCP server URL?
It is https://gitdiagram.com/mcp. Add it as a remote server in your app. The install box above has the exact steps.
Do I need an account or API key?
No. The README says it needs no key or sign-in.
Does it work on private repositories?
No. The server only handles public GitHub repositories. The GitDiagram website has a separate option for private repos with a GitHub token.
Can it change my repositories?
No. All its tools are read-only.
Will it make a new diagram if there is none?
Not by itself. It returns a link that makes the diagram when you open it in a browser.
Is the video tool always available?
Not always. The source only registers the video tool when videos are enabled on the server, so you may see two tools instead of three.
Information
updated Nov 2, 2026
- Publisher
- Official
- Endpoint
https://gitdiagram.com/mcp- Transport
- Streamable HTTP
- Auth
- None
- Version
- 1.0.0
- License
- MIT
- Last commit
- Oct 30, 2026
- Open issues
- 32
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- github.com · github.com
- github.com · github.com