MCP Tools

The Pensum MCP server exposes your vault to AI agents.

Setup

{
  "mcpServers": {
    "pensum": {
      "command": "node",
      "args": ["--import", "tsx/esm", "<path>/packages/mcp/src/server.ts"],
      "env": { "PENSUM_VAULT": "/path/to/your/vault" }
    }
  }
}

Discovery

Tool	Description
pensum_vault_summary	File count, entity counts, last scan time
pensum_capabilities	Version, mode, feature availability

Task tools

Tool	Description
task_today	Due/scheduled today + overdue
task_inbox	Tasks in inbox files
task_by_project	Open tasks for a project
task_overdue	Past-due tasks
task_this_week	Next 7 days
task_search	Text search (query, limit)
task_get	Get task by ULID
task_add	Add a task (description, file, due, priority, tags, provenance)
task_complete	Complete a task by ULID

Project tools

Tool	Description
project_list	All projects
project_dashboard	Open/overdue counts, task lists

Wiki tools

Tool	Description
wiki_stubs	Wiki entries

Cross-entity

Tool	Description
graph_search	Full-text search across all types

Capture

Tool	Description
capture_task	Capture with agent-suggested-pending provenance

Provenance

Every task includes a provenance field. Agents can filter by provenance: ["user-authored"] to exclude AI content.