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