# gitdone MCP server

> Lets an AI client track project completion status by verifying commits against a defined set of requirements in a git repository.

- Repository: https://github.com/ArtJack/gitdone
- Page: https://hostedmcp.org/servers/artjack/gitdone
- Transport: stdio
- Stars: 2
- License: MIT
- Latest version: 0.3.0

## Install

### Claude Code

```sh
claude mcp add gitdone -- uvx gitdone
```

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

```json
{
  "mcpServers": {
    "gitdone": {
      "command": "uvx",
      "args": [
        "gitdone"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "gitdone": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gitdone"
      ]
    }
  }
}
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "gitdone": {
      "command": "uvx",
      "args": [
        "gitdone"
      ]
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.gitdone]
command = "uvx"
args = ["gitdone"]
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "gitdone": {
      "command": "uvx",
      "args": [
        "gitdone"
      ]
    }
  }
}
```

## FAQ

### How does gitdone verify project status?

It uses a strict and weighted system where rows are only considered 'Live' when a commit on the default branch or a merged pull request confirms it.

### What is the difference between strict and weighted completion?

Strict counts only rows that are Live on the default branch, while weighted also credits work on branches or partial implementations based on defined weights.

### Does gitdone require an external server or account?

No, it is a local tool that lives within your repository and requires no account, server, or model calls.