README.md
MCP server for managing One-By-One (OBO) review sessions.
obo-mcp
MCP server for managing One-By-One (OBO) review sessions.
Provides 9 tools for creating, navigating, and resolving items in priority-scored
session files — replacing raw file-write calls in /obo workflows with proper MCP
tool calls.
Tools
| Tool | Description |
|---|---|
obo_create |
Create session file + update index.json atomically |
obo_list_sessions |
List sessions from index.json |
obo_session_status |
Summary stats for a session |
obo_next |
Next item: in_progress first, then highest-priority pending |
obo_list_items |
All items sorted by priority_score desc |
obo_get_item |
Full detail for one item |
obo_mark_complete |
Mark item completed with resolution text |
obo_mark_skip |
Mark item skipped |
obo_update_field |
Update any field; auto-recalculates priority_score |
Installation
Phase A (local dev):
"obo-mcp": {
"type": "stdio",
"command": "uvx",
"args": ["--from", "/Users/warnes/src/obo-mcp", "obo-mcp"]
}
Phase C (GitHub URL):
"obo-mcp": {
"type": "stdio",
"command": "uvx",
"args": ["--from", "git+https://github.com/warnes-innovations/obo-mcp", "obo-mcp"]
}
Session Format
Session files live at {base_dir}/.github/obo_sessions/session_YYYYMMDD_HHMMSS.json.
Priority score formula: urgency + importance + (6 - effort) + dependencies
Tools (9)
obo_createCreate session file and update index.json atomically.obo_list_sessionsList sessions from index.json.obo_session_statusSummary stats for a session.obo_nextGet next item based on progress and priority.obo_list_itemsList all items sorted by priority_score descending.obo_get_itemGet full detail for one item.obo_mark_completeMark item completed with resolution text.obo_mark_skipMark item skipped.obo_update_fieldUpdate any field and auto-recalculate priority_score.Configuration
claude_desktop_config.json
{"obo-mcp": {"type": "stdio", "command": "uvx", "args": ["--from", "git+https://github.com/warnes-innovations/obo-mcp", "obo-mcp"]}}Try it
→Create a new OBO review session for my current project.
→What is the next item I should work on in my current session?
→List all pending items in the current session sorted by priority.
→Mark the current item as complete with the note: 'Fixed the dependency issue'.
→Update the urgency field for the current item and show me the new priority score.