# GhostPaw Questlog MCP server

> Lets an AI client manage tasks, calendar commitments, and recurring work through a unified SQLite-based data model.

- Repository: https://github.com/GhostPawJS/questlog
- Page: https://hostedmcp.org/servers/ghostpawjs/questlog
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 0.14.2

## Install

### Claude Code

```sh
claude mcp add questlog -- npx -y @ghostpaw/questlog
```

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

```json
{
  "mcpServers": {
    "questlog": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/questlog"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "questlog": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/questlog"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"questlog","type":"stdio","command":"npx","args":["-y","@ghostpaw/questlog"]}'
```

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

```json
{
  "mcpServers": {
    "questlog": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/questlog"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add questlog -- npx -y @ghostpaw/questlog
```

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

```toml
[mcp_servers.questlog]
command = "npx"
args = ["-y", "@ghostpaw/questlog"]
```

### Gemini CLI

```sh
gemini mcp add -s user questlog npx -- -y @ghostpaw/questlog
```

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

```json
{
  "mcpServers": {
    "questlog": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/questlog"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `GHOSTPAW_QUESTLOG_DB` | no | no | SQLite database path (default: ~/.ghostpaw/questlog.db) |

## Tools (12)

- `search_questlog`
- `review_questlog`
- `inspect_questlog_item`
- `capture_rumor`
- `shape_work`
- `plan_quest`
- `run_quest`
- `organize_work`
- `manage_repeatable`
- `tag_work`
- `reward_work`
- `retire_work`

## FAQ

### Where is the questlog data stored?

Data is stored in a SQLite database located at ~/.ghostpaw/questlog.db by default, but you can specify a custom path using the GHOSTPAW_QUESTLOG_DB environment variable or the --db flag.

### How can I use Questlog with Claude Desktop?

Claude Desktop users can install the server by adding it to their claude_desktop_config.json or by installing the server.mcpb file from the latest GitHub release.

### What happens if I mark a task as done without an outcome?

The command will print a usage hint requiring an --outcome flag and then exit with code 2.
