# GhostPaw Questlog

> GhostPaw Questlog is an open-source MCP server for productivity. Local SQLite task list for agents where a task only finishes with a written outcome. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Website:** https://questlog.ghostpaw.dev
- **Repository:** https://github.com/ghostpawjs/questlog
- **MCP Registry name:** io.github.GhostPawJS/questlog
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

Questlog is built on a simple rule: an agent that ticks its own box grades its own homework, so a task, called a quest, cannot be finished without an outcome string. Work that depends on other work stays blocked until its prerequisite finishes successfully. The MCP tool run_quest refuses to start a blocked quest with an invalid_state error that names the open blocker, though force: true overrides it with a warning.

One table models tasks, deadlines (dueAt), appointments (scheduledStartAt and scheduledEndAt), not-before dates and recurring work using standard RRULE strings. Loose ideas are captured as rumours and later settled into questlines and quests. States such as available, blocked, overdue and done are computed from timestamps and unlocks on every read, so lists cannot go stale.

Data lives in a local SQLite file, by default ~/.ghostpaw/questlog.db, changeable through GHOSTPAW_QUESTLOG_DB. It runs over stdio as an npm package (Node.js 24 or newer) or a prebuilt binary, and also has a CLI. The authors suggest a plain TODO.md for short hand-edited lists and a hosted tracker for team workspaces.

## Features

- **Outcome required:** A quest cannot be finished unless a written outcome is recorded.
- **Prerequisite blocking:** Quests with unmet unlocks stay blocked and run_quest refuses to start them unless forced.
- **Calendar and deadlines:** Due dates, scheduled windows and not-before dates live in the same model.
- **Recurring work:** A standard RRULE string spawns a fresh quest each time one comes due.
- **Local SQLite store:** Data stays in a database file you can open, with zero runtime dependencies.

## Good for

- Make an agent record what it actually did for each task
- Sequence work so later steps wait for earlier ones
- Track deadlines and appointments across agent sessions
- Schedule weekly recurring chores for an agent
- Share one task store between a Node.js harness and MCP clients

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "questlog": {
      "command": "npx",
      "args": [
        "-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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## FAQ

### Where is the data stored?

In a local SQLite database, by default ~/.ghostpaw/questlog.db, or the path in GHOSTPAW_QUESTLOG_DB.

### What does it need to run?

The npm package needs Node.js 24 or newer; a binary bundles its own Node.js.

### Is it free?

The site says it is free and MIT licensed.

### Which clients can use it?

Any MCP client over stdio, with configuration shown for Claude Code, Codex CLI, Cursor and Claude Desktop.

### Is GhostPaw Questlog free?

Yes. GhostPaw Questlog is open source, so you can use and self-host it for free.

### How do I add GhostPaw Questlog to Claude Code?

Run this command in your terminal: claude mcp add questlog -- npx -y @ghostpaw/questlog

### What are the best alternatives to GhostPaw Questlog?

The closest alternatives to GhostPaw Questlog are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/ghostpaw-questlog
