Beans Mcp

Name: Beans Mcp
Author: selfagency

by selfagencycommunityv0.1.4

The MCP (Model Context Protocol) server for Beans provides programmatic and CLI interfaces for AI-powered interactions with Beans workspaces.

From the registry: Interact with the Beans CLI issue tracker agentically

GitHub Repository

Install & configure

Prerequisites

required
Install the Beans CLI
The Beans issue tracker CLI must be installed and its workspace initialised before running beans-mcp.
https://github.com/hmans/beans

Install in your client

Paste into the AI you're chatting with — it will figure out the rest

Please install the `beans-mcp` MCP server into my current AI client (that's you).

Required prerequisites (do these first if not already done):
- **Install the Beans CLI** — The Beans issue tracker CLI must be installed and its workspace initialised before running beans-mcp. (https://github.com/hmans/beans)

Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["@selfagency/beans-mcp","<your-beans-workspace-path>"]

Note: Server is started with a workspace root path as an argument. Optional --cli-path, --port, --log-dir flags exist.

Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.

Note: Server is started with a workspace root path as an argument. Optional --cli-path, --port, --log-dir flags exist.

Tools (11)

beans_init

Initialize the workspace (optional `prefix`).

beans_view

Fetch full bean details by `beanId` or `beanIds`.

beans_create

Create a new bean (title/type + optional body/parent).

beans_bulk_create

Create multiple beans in one call, optionally under a shared parent.

beans_update

Consolidated metadata + body updates (status/type/priority/parent/clearParent/blocking/blockedBy/body/bodyAppend/bodyReplace) plus optional optimistic concurrency hint (`ifMatch`).

beans_bulk_update

Update multiple beans in one call, optionally reassigning them to a shared parent.

beans_delete

Delete one or many beans (`beanId` or `beanIds`, optional `force`).

beans_reopen

Reopen a completed or scrapped bean to an active status.

beans_query

Unified list/search/filter/sort/ready/llm_context/open_config operations.

beans_bean_file

Read/edit/create/delete files under `.beans`.

beans_output

Read extension output logs or show guidance.