Skip to content
MCP server

GhostPaw Questlog

Local SQLite task list for agents where a task only finishes with a written outcome

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.14.2
Listing updated
3 days ago

About GhostPaw Questlog

GhostPaw Questlog is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "questlog": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/questlog"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "questlog": {
      "command": "npx",
      "args": [
        "-y",
        "@ghostpaw/questlog"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • GHOSTPAW_QUESTLOG_DBSQLite database path (default: ~/.ghostpaw/questlog.db)

What it does

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

Pricing

Open source

Free and MIT licensed

Prices change. Check questlog.ghostpaw.dev before you buy.

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 to GhostPaw Questlog

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media