Beans is a local-first issue tracker that lives in `.beans` folders, and this MCP server gives Claude full programmatic access to it. You get tools for creating, updating, querying, and archiving beans, plus bulk operations for batch work. The `beans_query` tool handles listing, filtering, and sorting with GraphQL passthrough. The `beans_update` tool consolidates status, priority, parent reassignment, body edits, and blocking relationships into one call with optimistic concurrency support. File operations let you read and write bean markdown files and frontmatter fields like branch and PR links. It validates paths to keep everything scoped to your workspace, caches unfiltered list results with automatic invalidation on mutations, and warns but doesn't block on CLI version mismatches.
claude mcp add --transport stdio selfagency-beans-mcp -- npx -y @selfagency/beans-mcp