TaskPaper mcp server

TaskPaper
1

I built an mcp server that reads and writes TaskPaper files directly. No AppleScript, no intermediary apps. It works with the plain text format natively.

If you use any AI tool that supports mcp (Claude Desktop, Kiro CLI, etc.), you can point it at your
.taskpaper files and manage tasks through conversation.

Examples:
Add a task to my Work project
show me everything tagged @due
move that task to Someday

What it can do:

  • List files, projects, tasks, and tags
  • Add tasks, projects, and notes (single or batch)
  • Add, remove, and modify tags on any item
  • Search by text, tag, or item type
  • Mark tasks done, archive completed items, move tasks between projects
  • Full parsed outline as structured data

Setup is simple. Add this to your mcp config:

{
  "mcpServers": {
    "taskpaper": {
      "command": "npx",
      "args": ["taskpaper-mcp"],
      "env": {
        "TASKPAPER_DIR": "/path/to/your/taskpaper/files"
      }
    }
  }
}

GitHub source: GitHub - brokosz/taskpaper-mcp: MCP server for reading and writing TaskPaper plain text files. · GitHub
MIT licensed, open source. Feedback and contributions welcome.

2 Likes