# Selfagency Beans MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.github.selfagency%2Fbeans-mcp
Registry id: `mcp-registry/io.github.selfagency/beans-mcp`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "selfagency-beans-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@selfagency/beans-mcp"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add selfagency-beans-mcp-server -- npx -y @selfagency/beans-mcp
```

## Tools (13)

- `beans_archive`: Archive completed/scrapped beans.
- `beans_bean_file`: Read/edit/create/delete files under .beans.
- `beans_bulk_create`: Create multiple beans in one call, optionally under a shared parent.
- `beans_bulk_update`: Update multiple beans in one call, optionally reassigning them to a shared parent.
- `beans_complete_tasks`: Mark all markdown checklist tasks within a bean as complete.
- `beans_create`: Create a new bean (title/type + optional body/parent).
- `beans_delete`: Delete one or many beans (beanId or beanIds, optional force).
- `beans_init`: Initialize the workspace (optional prefix).
- `beans_output`: Read extension output logs or show guidance.
- `beans_query`: Unified list/search/filter/sort/ready operations, with GraphQL passthrough.
- `beans_reopen`: Reopen a completed or scrapped bean to an active status.
- `beans_update`: Consolidated metadata + body updates (status/type/priority/parent/clearParent/blocking/blockedBy/body/bodyAppend/bodyReplace) plus optional optimistic concurren
- `beans_view`: Fetch full bean details by beanId or beanIds.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.