beans-mcp

MCP server for Beans issue tracker

Return to top

Getting Started ​

Requirements ​

  • Node.js 18+
  • pnpm 10+
  • Beans CLI available in PATH (or provide --cli-path)

Run the server ​

bash

npx @selfagency/beans-mcp /path/to/workspace

Or with explicit flags:

bash

npx @selfagency/beans-mcp --workspace-root /path/to/workspace --cli-path beans --port 39173

CLI arguments ​

  • workspace-root (positional) or --workspace-root / --workspace
  • --cli-path <path>
  • --port <number>
  • --log-dir <path>
  • -h, --help

Workspace resolution order ​

  1. Explicit CLI workspace argument
  2. MCP roots from connected client
  3. Current working directory

First commands to run from your MCP client ​

  1. beans_init (optional, if workspace not initialized)
  2. beans_query with operation: refresh
  3. beans_view on specific IDs

Related Servers

NotebookLM Web Importer

Import web pages and YouTube videos to NotebookLM with one click. Trusted by 200,000+ users.

Install Chrome Extension