A hosted server that reads any public GitHub repo's docs and code on request.
- Needs your setup first
- ★ 8.5K GitHub stars
- 33 downloads a week
- Last commit 8 May 2026
At a glance
GitMCP runs in the cloud, so there is nothing to install: you add a URL. Point it at one repository (gitmcp.io/owner/repo) and the assistant gets tools to fetch that project's documentation, search it and search its code. Use the generic address, gitmcp.io/docs, and the model picks the repository itself for each question.
It reads llms.txt first when a project has one, then the README. That makes it a light, free way to stop a model guessing at a library it knows badly, without any account.
- Made by
- The GitMCP project (idosal/git-mcp), free and open source
- GitHub stars
- 8.5K
- Downloads
- 33 a week
- Last commit
- 8 May 2026
- Tools
- 5
- Runs on
- Hosted
Our check: It needs something our Linux test machine does not have (an account, a desktop app, a Mac or a running service), so on 27 Oct 2026 we read its tools from the source code instead of running this config. The npm package called "git-mcp" has no link to this project. GitMCP is a hosted service; the repository is its source, for anyone who wants to run their own copy.
What's in the pod: its tools
We found 5 tools in its source code on 27 Oct 2026. Every one of them only reads, so nothing changes unless you act on what it finds.
How we tested it: Read from the GitMCP source for the generic /docs address. Our test network could not reach gitmcp.io. A repository address such as gitmcp.io/owner/repo names the tools after that repository instead.
Only reads5 tools · Looks things up and changes nothing.
| Tool | What it is for |
|---|---|
fetch_generic_documentation | Fetches a repository's main documentation: llms.txt if the project has one, otherwise its README. |
fetch_generic_url_content | Fetches a page that the documentation links to, respecting robots.txt. |
match_common_libs_owner_repo_mapping | Turns a library name, such as "three.js", into its GitHub owner and repository, when you have not named one. |
search_generic_code | Searches a repository's code through GitHub code search, 30 results a page. |
search_generic_documentation | Searches a repository's documentation for a question and returns the relevant passages instead of the whole thing. |
Grouped and described by us. The README on GitHub lists the inputs each tool takes.
Set it up
Pick your app for the exact snippet and where it goes.
Where it goes: Settings → Connectors → Add custom connector
https://gitmcp.io/docsPaste the URL and sign in if asked. Custom connectors depend on your plan.
Where it goes: Your terminal, in the project folder
claude mcp add --transport http gitmcp https://gitmcp.io/docsWhere it goes: ~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
"mcpServers": {
"gitmcp": {
"url": "https://gitmcp.io/docs"
}
}
}Where it goes: .vscode/mcp.json in your project
{
"servers": {
"gitmcp": {
"type": "http",
"url": "https://gitmcp.io/docs"
}
}
}Where it goes: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gitmcp": {
"serverUrl": "https://gitmcp.io/docs"
}
}
}Where it goes: Settings → Apps & Connectors → create a connector
https://gitmcp.io/docsPaste the URL as the connector address and sign in if asked.
Swap /docs for /owner/repo (for example https://gitmcp.io/microsoft/playwright-mcp) to lock it to one project and get tools named after it.
New to this? See the setup guides for Claude Code, Cursor, Claude Desktop and ChatGPT.
Settings
Names are exactly as the project spells them. Required ones are marked.
| Setting | What it does |
|---|---|
https://gitmcp.io/docsConfig | The generic address: one server for every public repository, with the model naming the owner and repository on each call. |
https://gitmcp.io/{owner}/{repo}Config | Locks the server to one repository. The tools are then named after that repository, which makes the model more likely to pick them for questions about it.https://gitmcp.io/microsoft/playwright-mcp |
https://{owner}.gitmcp.io/{repo}Config | The same for a project's GitHub Pages documentation site.https://langchain-ai.gitmcp.io/langgraph |
npx mcp-remoteConfig | A stdio bridge for clients that cannot connect to a URL: use npx mcp-remote https://gitmcp.io/owner/repo as the command. |
What it can touch
It can read
- Public GitHub repositories: their docs, README, llms.txt and code
- Web pages those docs link to
It can change
Safer setup: Everything it does is read-only. A repository-specific URL keeps the model from wandering to repositories you did not mean.
Before you start
- Nothing: no account, key or install
- A client that can connect to a remote URL (or mcp-remote as a bridge)
If it does not work
- The model picks the wrong repository
- Use the repository-specific address instead of /docs, or name owner/repo in your prompt.
- Answers are thin for a project
- GitMCP reads llms.txt first, then the README. Projects with little written documentation give it little to work with; search_generic_code can still find examples in the source.
- Private repositories do not work
- The hosted service only reads public repositories. For private code, use the GitHub MCP server with a token instead.
Peas in a pod: similar servers
How GitMCP lines up against other developer tools servers on the shelf.
| Server | Tools | Runs on | Licence | Stars |
|---|---|---|---|---|
| GitMCP | 5 | Hosted | – | 8.5K |
| GhidraMCP | 30 | Your computer | – | 11.6K |
| shadcn/ui MCP | 10 | Your computer | MIT | 3.1K |
| jCodeMunch | 6 | Your computer | LicenseRef-jCodeMunch-Dual-Use-1 | 2.8K |
| iOS Simulator MCP | 17 | Your computer | MIT | 2.2K |
Questions
Is GitMCP free?
Yes. It is free, needs no sign-up and, according to its makers, does not store queries or personal data.
How is it different from Context7?
Context7 serves a curated, indexed library catalogue. GitMCP works on any public repository straight from its own docs and code, with no index to wait for.
Can I run my own copy?
Yes. The source is on GitHub under the Apache-2.0 licence and runs on Cloudflare Workers.
Does it work with GitHub Pages docs sites?
Yes, through the owner.gitmcp.io/repo form of the address.
Something wrong on this page? Tell us.
