Agendum MCP server
✓ VerifiziertBietet KI-Agenten ein persistentes Projektgedächtnis, Task-Tracking und abgegrenzte Arbeitspakete, um die Kontinuität über verschiedene Sessions hinweg zu gewährleisten.
Auch bekannt als sralli/agendum
- Stars
- 6
- Tools
- 14
- Downloads, 30 Tage
- 103
- Neueste Version
- 0.3.4
- Letzter Commit
- 13. Apr. 2026
- Lizenz
- MIT
Was ist Agendum MCP?
Bietet KI-Agenten ein persistentes Projektgedächtnis, Task-Tracking und abgegrenzte Arbeitspakete, um die Kontinuität über verschiedene Sessions hinweg zu gewährleisten. Er stellt 14 Tools bereit, etwa pm_init, pm_project, pm_status.
Zusammenfassung generiert aus dem README des Projekts
Über Agendum MCP server
Agendum ermöglicht es, die Kontinuität für KI-Coding-Agenten während komplexer Entwicklungszyklen aufrechtzuerhalten. Es bietet ein persistentes Memory- und Scoping-Engine, das verhindert, dass zustandslose Agenten Entscheidungen vergessen oder den Kontext zwischen Sessions verlieren. Durch die Nutzung dieses MCP server mit Clients wie Claude Code, Cursor, Windsurf oder Cline können Entwickler einen Agenten von einem Tool, das wahllos Dateien modifiziert, in eines verwandeln, das innerhalb abgegrenzter Arbeitspakete mit spezifischen Akzeptanzkriterien und Constraints arbeitet.
Das System verwaltet einen Dependency Graph, um Tasks zu ordnen und Items automatisch freizuschalten, sobald die Arbeit abgeschlossen ist. Es nutzt verschiedene Tools, darunter pm_ingest zum Importieren von Markdown-Plänen, pm_next zum Abrufen des nächsten scoped Tasks und pm_done zum Protokollieren von Entscheidungen und Mustern. Der gesamte Projektzustand wird in menschenlesbaren Markdown- und YAML-Dateien gespeichert, wodurch das Memory via Git diffbar und committable ist. Der Server bietet zudem eine hybride Suchfunktion, die Keyword-Matching, Vector Search und einen Entity Graph kombiniert, um relevantes Projektwissen bereitzustellen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Agendum MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenAgendum MCP in Claude Code installieren
$ claude mcp add agendum -- uvx agendumAgendum MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"agendum": {
"command": "uvx",
"args": [
"agendum"
]
}
}
}Agendum MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"agendum": {
"type": "stdio",
"command": "uvx",
"args": [
"agendum"
]
}
}
}Agendum MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"agendum","type":"stdio","command":"uvx","args":["agendum"]}'Agendum MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"agendum": {
"command": "uvx",
"args": [
"agendum"
]
}
}
}Agendum MCP in Codex installieren
$ codex mcp add agendum -- uvx agendumAgendum MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.agendum] command = "uvx" args = ["agendum"]
Agendum MCP in Gemini CLI installieren
$ gemini mcp add -s user agendum uvx -- agendumAgendum MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"agendum": {
"command": "uvx",
"args": [
"agendum"
]
}
}
}Agendum MCP tools 14
Erkannt aus dem READMEpm_initpm_projectpm_statuspm_addpm_boardpm_ingestpm_nextpm_donepm_blockpm_memorypm_learnpm_search
| pm_init | — | |
| pm_project | — | |
| pm_status | — | |
| pm_add | — | |
| pm_board | — | |
| pm_ingest | — | |
| pm_next | — | |
| pm_done | — | |
| pm_block | — | |
| pm_memory | — | |
| pm_learn | — | |
| pm_search | — |
Alle 14 Tools anzeigenWeniger Tools anzeigen
pm_consolidatepm_supersede
| pm_consolidate | — | |
| pm_supersede | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarsralli/agendum is public and reachablegithub.com/sralli/agendum ↗Bestanden
- Paket nennt dieses Repository als Quelleagendum names sralli/agendum as sourcepypi.org/project/agendum/ ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-04-13github.com/sralli/agendum ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from agendumBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten40 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell14 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenagendum
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.
| Without agendum | With agendum |
|---|---|
| Agent forgets everything between sessions | Picks up exactly where it left off |
| No scope — agent modifies random files | Bounded work packages with file lists, acceptance criteria, constraints |
| Decisions lost — same mistakes repeated | Decisions and patterns persist in searchable memory |
| No task ordering — agent picks randomly | Dependency graph with auto-unblocking and priority scoring |
| Learning locked inside one project | Cross-project learnings carry patterns forward |
Quick Start
pip install agendum # or: uvx agendum
claude mcp add agendum -- uvx agendum --home serve # add to Claude Code
# Done. pm_* tools are now available in your agent.
Works with any MCP client — see setup for Cursor, Windsurf, VS Code, and others.
How It Works
flowchart LR
A["PLAN\nwrite plan file"] --> B["pm_ingest\nboard items + deps"]
B --> C["pm_next\nwork package + context"]
C --> D["EXECUTE\nagent implements"]
D --> E["pm_done\ndecisions + patterns"]
E -->|next task| C
E -->|new session| F["pm_status\nresume context"]
F --> C
Each pm_done records decisions and patterns that enrich future pm_next calls — context compounds across sessions.
Example session:
You: I have a plan file for the API rewrite. Ingest it.
Agent:
→ pm_ingest(project="api-rewrite", plan_file="plan.md")
Ingested 4 board items from plan:
item-001: Schema design [high]
item-002: Resolver layer (depends on item-001)
item-003: Auth middleware (depends on item-001)
item-004: Integration tests (depends on item-002, item-003)
You: What should I work on?
Agent:
→ pm_next(project="api-rewrite")
Work package for item-001 "Schema design":
Context: project rules, memory from last session
Scope: Define GraphQL schema types
Acceptance criteria: Types for User, Product, Order
You: Done with the schema. Here's what I decided...
Agent:
→ pm_done(project="api-rewrite", item_id="item-001",
decisions="Using code-first with Strawberry",
patterns="N+1 queries need DataLoader",
verified=True)
Marked item-001 as done. Unblocked: item-002, item-003
> Next: pm_next("api-rewrite") to continue with newly unblocked tasks
14 MCP Tools
Setup & Orientation
| Tool | Purpose |
|---|---|
pm_init |
Initialize board directory (optional — auto-initializes on first use) |
pm_project |
Create, list, or get projects |
pm_status |
Dashboard — item counts, recent progress, memory health, suggested next task |
Planning & Backlog
| Tool | Purpose |
|---|---|
pm_add |
Add an item with type, priority, tags, dependencies, acceptance criteria |
pm_board |
View and filter the project board |
pm_ingest |
Import a Markdown plan file into bounded board items with dependencies |
Execution Loop
| Tool | Purpose |
|---|---|
pm_next |
Get the next scoped work package with complexity signal and enriched context |
pm_done |
Complete an item — record decisions, patterns, learnings; auto-extract from git; auto-unblock dependents |
pm_block |
Report a task as blocked with reason |
Knowledge & Search
| Tool | Purpose |
|---|---|
pm_memory |
Read, write, append, or search project memory (decisions, patterns, project knowledge) |
pm_learn |
Record global or project-scoped learnings with tags and topic entities |
pm_search |
Hybrid search across all knowledge — memory, learnings, completed items |
pm_consolidate |
Clean memory corruption, deduplicate learnings, detect contradictions |
pm_supersede |
Soft-invalidate a learning — excluded from all future searches |
Hybrid Search
pm_search combines three signals to find relevant knowledge across memory, learnings, and completed board items:
- FTS5 with Porter stemming —
authmatchesauthentication,configmatchesconfiguration. Always on, zero config. - Vector search (optional) — Install
agendum[vectors]to add semantic similarity viafastembed+sqlite-vec. Activates automatically alongside FTS5. - Entity graph — Topics and tags form a knowledge graph. Entries sharing 2+ entities are linked automatically. Graph expansion surfaces related knowledge that keyword search misses.
All three signals are fused via Reciprocal Rank Fusion (RRF), then reranked by recency and access frequency. The index rebuilds from Markdown files — no data loss if it gets corrupted.
Key Capabilities
- Adaptive context budget — enrichment scales with task complexity: 4K chars for trivial tasks, up to 10K for large ones
- Verification gate —
pm_done(verified=True)distinguishes tested from untested completions - Git auto-extract —
pm_donereadsgit diffandgit logautomatically when no files are specified - Pluggable enrichment pipeline — four context sources injected into every work package: project rules (CLAUDE.md/AGENTS.md), memory, dependency context, learnings
- Dependency resolution — topological ordering with cycle detection; dependents unblock automatically when upstream tasks complete
- Memory health —
pm_statuswarns about corrupted entries;pm_consolidatestrips XML fragments, deduplicates, and flags contradictions - Zero config — auto-initializes on first tool call, derives board name from git remote
- Git-native storage — all state is human-readable Markdown + YAML in
.agendum/, diffable and committable
Installation
All MCP clients except VS Code use the same config. Add to the appropriate file:
{
"mcpServers": {
"agendum": {
"command": "uvx",
"args": ["agendum", "--home", "serve"]
}
}
}
| Client | Config location |
|---|---|
| Claude Code | Run: claude mcp add agendum -- uvx agendum --home serve |
| Cursor | .cursor/mcp.json in project root |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
| Cline | Settings › MCP Servers › Edit |
| Roo Code | MCP settings file |
| Claude Desktop | claude_desktop_config.json |
VS Code (GitHub Copilot): Uses
"servers"instead of"mcpServers". Add to.vscode/mcp.json:{ "servers": { "agendum": { "command": "uvx", "args": ["agendum", "--home", "serve"] } } }
CLI (standalone)
pip install agendum
agendum project create my-app # Create a project
agendum status # Dashboard overview
agendum next my-app # Suggest next task
Storage Layout
All state lives in ~/.agendum/ (or .agendum/ in your project if you prefer local storage):
~/.agendum/
├── .cache/
│ └── search.db # FTS5 + vector search index (auto-rebuilt)
├── config.yaml
├── projects/
│ └── webapp/
│ ├── project.yaml # Project metadata
│ ├── board/
│ │ ├── item-001.md # Markdown + YAML frontmatter
│ │ └── item-002.md
│ └── learnings/ # Project-scoped learnings
│ └── learning-001.md
├── learnings/ # Cross-project learnings
│ └── learning-001.md
└── memory/
├── decisions.md # Key decisions + rationale
└── patterns.md # Discovered conventions
Architecture
src/agendum/
├── server.py # MCP server wiring (FastMCP)
├── tools.py # 14 MCP tools
├── models.py # Pydantic models (BoardItem, WorkPackage, SearchResult)
├── task_graph.py # Dependency resolution + topological levels
├── config.py # Shared configuration
├── env_context.py # Git diff/log auto-extraction
├── cli.py # CLI interface
├── enrichment/
│ ├── pipeline.py # ContextEnricher, budget allocation
│ └── sources.py # ProjectRules, Memory, Dependency, Learnings sources
└── store/
├── board_store.py # BoardItem CRUD
├── board_format.py # Markdown <-> BoardItem serialization
├── project_store.py # Project metadata
├── memory_store.py # Scoped memory storage
├── learnings_store.py # Global and project-scoped learnings
├── search_index.py # FTS5 + vector + entity graph + RRF
├── embedding.py # Lazy fastembed wrapper (optional)
└── locking.py # get_lock() + atomic_write()
Development
git clone https://github.com/sralli/agendum.git
cd agendum
uv sync
uv run pytest tests/ -v # all tests
uv run ruff check . # lint
uv run ruff format --check . # format check
License
MIT
Agendum MCP Fragen
Wie füge ich Agendum MCP zu Claude Code hinzu?
Führe claude mcp add agendum -- uvx agendum in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Agendum MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet Agendum MCP?
Er stellt 14 Tools bereit, darunter pm_init, pm_project, pm_status, pm_add, pm_board.
Welches Problem löst Agendum für KI-Agenten?
Es adressiert die zustandslose Natur von KI-Coding-Agenten, indem es einen persistenten Projektzustand, abgegrenzte Arbeitspakete und Kontinuität über Sessions hinweg bereitstellt.
Wie verwaltet Agendum Task-Abhängigkeiten?
Es nutzt einen Dependency Graph mit topologischer Sortierung und Zyklenerkennung, sodass Tasks automatisch freigeschaltet werden, sobald ihre Abhängigkeiten abgeschlossen sind.
Wo werden die Projektdaten gespeichert?
Der gesamte Zustand wird in menschenlesbaren Markdown- und YAML-Dateien innerhalb eines .agendum/ Verzeichnisses gespeichert, was das System git-native und diffbar macht.
Kann ich semantische Suche mit Agendum nutzen?
Ja, durch die Installation der optionalen Vector-Extension kannst du eine semantische Ähnlichkeitssuche mittels fastembed und sqlite-vec hinzufügen.