sralli avatar

Agendum

sralli/agendum

Persistent project memory for AI coding agents that actually need to ship multi-session work. Adds 14 MCP tools to Claude, Cursor, or Windsurf for ingesting plan files into dependency-graphed work packages, pulling scoped tasks with file lists and acceptance criteria, and recording decisions that enrich future context. The pm_next tool returns bounded work packages with adaptive context budgets based on task complexity, while pm_done captures patterns and auto-unblocks dependent tasks. Hybrid search across FTS5, optional vector embeddings, and entity graphs surfaces relevant decisions from past sessions. Storage is git-native Markdown in .agendum/ so state diffs and commits cleanly. Solves the core problem of agents forgetting everything between sessions and thrashing across unbounded codebases without task ordering or institutional memory.

GitHub stars
6
tools
14
transport
STDIO
last updated
Apr 13, 2026

Tools

14 tools

Public tool metadata for what this MCP can expose to an agent.

pm_initInitialize board directory (optional — auto-initializes on first use)

Initialize board directory (optional — auto-initializes on first use)

No parameter schema in public metadata yet.

pm_projectCreate, list, or get projects

Create, list, or get projects

No parameter schema in public metadata yet.

pm_statusDashboard — item counts, recent progress, memory health, suggested next task

Dashboard — item counts, recent progress, memory health, suggested next task

No parameter schema in public metadata yet.

pm_addAdd an item with type, priority, tags, dependencies, acceptance criteria

Add an item with type, priority, tags, dependencies, acceptance criteria

No parameter schema in public metadata yet.

pm_boardView and filter the project board

View and filter the project board

No parameter schema in public metadata yet.

pm_ingestImport a Markdown plan file into bounded board items with dependencies

Import a Markdown plan file into bounded board items with dependencies

No parameter schema in public metadata yet.

pm_nextGet the next scoped work package with complexity signal and enriched context

Get the next scoped work package with complexity signal and enriched context

No parameter schema in public metadata yet.

pm_doneComplete an item — record decisions, patterns, learnings; auto-extract from git; auto-unblock dependents

Complete an item — record decisions, patterns, learnings; auto-extract from git; auto-unblock dependents

No parameter schema in public metadata yet.

pm_blockReport a task as blocked with reason

Report a task as blocked with reason

No parameter schema in public metadata yet.

pm_memoryRead, write, append, or search project memory (decisions, patterns, project knowledge)

Read, write, append, or search project memory (decisions, patterns, project knowledge)

No parameter schema in public metadata yet.

pm_learnRecord global or project-scoped learnings with tags and topic entities

Record global or project-scoped learnings with tags and topic entities

No parameter schema in public metadata yet.

pm_searchHybrid search across all knowledge — memory, learnings, completed items

Hybrid search across all knowledge — memory, learnings, completed items

No parameter schema in public metadata yet.

pm_consolidateClean memory corruption, deduplicate learnings, detect contradictions

Clean memory corruption, deduplicate learnings, detect contradictions

No parameter schema in public metadata yet.

pm_supersedeSoft-invalidate a learning — excluded from all future searches

Soft-invalidate a learning — excluded from all future searches

No parameter schema in public metadata yet.

Sponsors

Readme

agendum

PyPI version Downloads Python 3.13+ Tests License: MIT

Project memory and scoping engine for AI coding agents.

AI coding agents are stateless — they forget between sessions, lose decisions, and have no way to scope complex work. agendum is an MCP server that gives any agent (Claude Code, Cursor, Windsurf, Cline, and others) persistent project state, bounded work packages, and cross-session continuity.


View the full README on GitHub

Details

Repository
github.com/sralli/agendum
Categories
AI & LLM Tools, Productivity & Office
Package
agendum
Transport
STDIO
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1vornicx avatarMidasvornicx/midasLocal-first, source-traceable agent memory — no LLM at ingest, fully offline6stars
2bahfahh avatarNoteit Mcpbahfahh/noteit-mcpMCP server for AI agent profiles and smart notes. 60+ coding prompt packs with expert personas.5stars
3blackfoil avatarClaude Token Saver Mcpblackfoil/claude-token-saver-mcpMCP server that offloads routine coding tasks to local LLM (Ollama) to save Claude API tokens4stars
4j-east avatarPixel Surgeonj-east/pixel-surgeon-mcpAI image and video generation, editing, and region repair via Gemini, OpenAI, and Grok.4stars
5lore-context avatarLore Contextlore-context/lore-contextGoverned AI-agent memory, Evidence Ledger traces, evals, and portable context tools.4stars
6n24q02m avatarImagine Mcpn24q02m/imagine-mcpMCP server for image/video understanding & generation (Gemini/OpenAI/Grok)4stars