Shadowgit

aflsolutions50starsClaim this server

A Model Context Protocol (MCP) server that provides AI assistants with secure, read-only access to your ShadowGit repositories. This enables powerful debugging and code analysis capabilities by giving

Install Run on PlugMCPClaim this server

GitHub

Run on PlugMCP

1# Shadowgit

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-27

Stars: 50
Tools: —
Uptime: —

Overview

About Shadowgit

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Shadowgit?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Shadowgit need an API key?

No required environment variable is listed on this record.

What transport does Shadowgit use?

Shadowgit runs locally over stdio.

When was Shadowgit last checked?

Last checked 2026-10-27. A Model Context Protocol (MCP) server that provides AI assistants with secure, read-only access to your ShadowGit repositories. This enables powerful debugging and code analysis capabilities by giving AI access to your project's fine-grained git history.

From the publisher

Documentation

ShadowGit MCP server

Gives Claude Code, Cursor and Claude Desktop access to ShadowGit: the automatic snapshots ShadowGit takes of your projects every few minutes, kept apart from your own git history. Your assistant can see what changed and when, and can save its own edits as one named checkpoint instead of many partial snapshots.

Requirements

Node.js 20 or later
The ShadowGit app (0.3.4 or later for checkpoints, a release after 0.3.5 for the Lens, after 0.3.7 for its linked words, after 0.3.9 for the map, after 0.3.10 for the Lens's dependency facts, 0.3.11 or later for the project's rules), tracking at least one project. Reading history works while the app is closed; sessions, checkpoints, the Lens and the map need it running.
Git on your PATH

Setup

Claude Code (one install for every project):

claude mcp add --scope user shadowgit -- npx -y shadowgit-mcp-server

Cursor: in ~/.cursor/mcp.json:

{ "mcpServers": { "shadowgit": { "command": "npx", "args": ["-y", "shadowgit-mcp-server"] } } }

Claude Desktop: the same entry in ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

In Claude Code the server knows which project you are in. In Cursor and Claude Desktop, name the project ("in webshop") when ShadowGit tracks more than one.

What to ask

"What changed in the last hour?"
"When did the login page break?"
"Show me the history of Header.tsx"
"How is this project organised?"
"What depends on chargeCard?"
"Start a ShadowGit session for this refactor", then "Create a checkpoint: Fixed login redirect", then "End the ShadowGit session"
"Write the Lens words for this session"

Tools

Tool	Does
`list_repos`	Lists tracked projects, the current one, their last snapshot and any active session
`git_command`	Runs a read-only git command (`log`, `diff`, `show`, `blame`, …) on the snapshot history
`get_map`	Gives how the project is organised: its areas, layers and the links between them, or one area, and the project's rules
`get_code_context`	Gives where files and symbols sit, what depends on them, where a change to them lands, and the project's rules for them
`start_session`	Pauses automatic snapshots while the assistant edits
`checkpoint`	Saves the current changes as one named checkpoint, following `.shadowgit-ignore`, then checks it against the project's `.shadowgit-rules`
`end_session`	Resumes automatic snapshots
`get_lens`	Reads ShadowGit's Lens of a range, by default the latest AI session, with what it makes depend on what and the links a rule names
`write_lens_words`	Writes the Lens's words for that range, kept in the history, with links, a why and an excerpt

The other tools work on the current project unless given repo.

Security

git_command runs only read-only subcommands, without a shell, and refuses the options that would read or write files outside the snapshot history (--output, --no-index, blame --contents and others, including abbreviated and bundled forms), the ones that run helper commands from git's configuration (--ext-diff, --textconv, --filters), and paths outside the project. Checkpoints are made by the ShadowGit app, only in projects you added to it. The server itself only talks to the ShadowGit app on localhost; what it returns goes to your assistant like any tool result.

The server trusts the project's .shadowgit.git history, which the ShadowGit app creates. Git honours that history's configuration, so a planted one can make git run programs, through the app's own snapshots as much as through this server. Don't add a project to ShadowGit that arrived with a .shadowgit.git folder you didn't create.

Configuration

Variable	Default	Purpose
`SHADOWGIT_TIMEOUT`	`10000`	Milliseconds a git command may run
`SHADOWGIT_SESSION_API`	`http://localhost:45289/api`	The ShadowGit app's local API
`SHADOWGIT_STORAGE_DIR`	platform default	Where ShadowGit keeps `repos.json`

Development

npm install
npm test        # builds, then runs the unit, integration and end-to-end tests
npm run eval    # runs the phrases from docs.shadowgit.com through Claude Code (spends tokens)

License

MIT

Shadowgit

aflsolutions50starsClaim this server

Install Run on PlugMCPClaim this server

GitHub

Run on PlugMCP

1# Shadowgit

README.mdMCP server

Transport: stdio
Status: Local

Power your agent

Add this server

Install from the publisher. Not a PlugMCP endpoint.

Run on PlugMCP

Host a copy with our keys and logs.

No packaged release in the registry yet. Follow the repository README.

RepositoryPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
License: MIT
Last checked: 2026-10-27

Stars: 50
Tools: —
Uptime: —

Overview

About Shadowgit

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

How do I install Shadowgit?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Shadowgit need an API key?

No required environment variable is listed on this record.

What transport does Shadowgit use?

Shadowgit runs locally over stdio.

When was Shadowgit last checked?

From the publisher

Documentation

ShadowGit MCP server

Requirements

Node.js 20 or later
The ShadowGit app (0.3.4 or later for checkpoints, a release after 0.3.5 for the Lens, after 0.3.7 for its linked words, after 0.3.9 for the map, after 0.3.10 for the Lens's dependency facts, 0.3.11 or later for the project's rules), tracking at least one project. Reading history works while the app is closed; sessions, checkpoints, the Lens and the map need it running.
Git on your PATH

Setup

Claude Code (one install for every project):

claude mcp add --scope user shadowgit -- npx -y shadowgit-mcp-server

Cursor: in ~/.cursor/mcp.json:

{ "mcpServers": { "shadowgit": { "command": "npx", "args": ["-y", "shadowgit-mcp-server"] } } }

Claude Desktop: the same entry in ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).

In Claude Code the server knows which project you are in. In Cursor and Claude Desktop, name the project ("in webshop") when ShadowGit tracks more than one.

What to ask

"What changed in the last hour?"
"When did the login page break?"
"Show me the history of Header.tsx"
"How is this project organised?"
"What depends on chargeCard?"
"Start a ShadowGit session for this refactor", then "Create a checkpoint: Fixed login redirect", then "End the ShadowGit session"
"Write the Lens words for this session"

Tools

Tool	Does
`list_repos`	Lists tracked projects, the current one, their last snapshot and any active session
`git_command`	Runs a read-only git command (`log`, `diff`, `show`, `blame`, …) on the snapshot history
`get_map`	Gives how the project is organised: its areas, layers and the links between them, or one area, and the project's rules
`get_code_context`	Gives where files and symbols sit, what depends on them, where a change to them lands, and the project's rules for them
`start_session`	Pauses automatic snapshots while the assistant edits
`checkpoint`	Saves the current changes as one named checkpoint, following `.shadowgit-ignore`, then checks it against the project's `.shadowgit-rules`
`end_session`	Resumes automatic snapshots
`get_lens`	Reads ShadowGit's Lens of a range, by default the latest AI session, with what it makes depend on what and the links a rule names
`write_lens_words`	Writes the Lens's words for that range, kept in the history, with links, a why and an excerpt

The other tools work on the current project unless given repo.

Security

Configuration

Variable	Default	Purpose
`SHADOWGIT_TIMEOUT`	`10000`	Milliseconds a git command may run
`SHADOWGIT_SESSION_API`	`http://localhost:45289/api`	The ShadowGit app's local API
`SHADOWGIT_STORAGE_DIR`	platform default	Where ShadowGit keeps `repos.json`

Development

npm install
npm test        # builds, then runs the unit, integration and end-to-end tests
npm run eval    # runs the phrases from docs.shadowgit.com through Claude Code (spends tokens)

License

MIT