GhostPaw Questlog
Local SQLite task list for agents where a task only finishes with a written outcome
- 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/questlogAdd to claude_desktop_config.json
{
"mcpServers": {
"questlog": {
"command": "npx",
"args": [
"-y",
"@ghostpaw/questlog"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"questlog": {
"command": "npx",
"args": [
"-y",
"@ghostpaw/questlog"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media