MCP

Connect quickly to Claude, Claude Code, or Codex

Already logged in (bee login)? Connect your assistant in one command:


bee mcp connect claude          # Claude Desktop (one-click install)
bee mcp connect claude-code     # Claude Code (CLI)
bee mcp connect codex           # Codex

That’s it — your assistant can now read your Bee context (conversations, facts, todos, daily summaries) directly from this computer. Check or undo with bee mcp status / bee mcp disconnect <client>.

The only prerequisite is a prior bee login. If you are not signed in, connect stops early with Not logged in. Run "bee login" first.

What this is

The Bee CLI is also a Model Context Protocol server, so assistants like Claude and Codex can read your Bee context — search conversations, look up facts and todos, fetch daily summaries — directly, with your data staying on your machine.

The server authenticates with your existing Bee login, so there is no extra token to manage for the connector path (stdio). The connected client launches the local Bee CLI, which signs in with your stored Bee credentials.

Connectors

Wire Bee into a specific assistant. connect claude generates a Claude Desktop one-click install package and opens it in Claude (click Install to finish); claude-code and codex register Bee directly with those clients.


bee mcp connect claude          # Claude Desktop (one-click install)
bee mcp connect claude-code     # Claude Code (CLI)
bee mcp connect codex           # Codex
 
bee mcp status                  # show what's connected
bee mcp disconnect claude       # remove (claude | claude-code | codex)

bee mcp status reports the launch command and which clients are connected. bee mcp disconnect <client> undoes a connection for claude, claude-code, or codex.

Transports

To run the server yourself — for another MCP client, or to debug — use one of the transports directly.

stdio


bee mcp serve

Stdio JSON-RPC 2.0. This is what the connectors launch under the hood; it uses your stored Bee login, so no token is required.

serve-http security. The HTTP transport requires an auth token:

Required, and at least 32 characters long.
Supplied with --token <value> or the BEE_MCP_HTTP_TOKEN environment variable.
Never printed by the CLI.
The server binds to 127.0.0.1 only and rejects non-localhost Host/Origin headers.
Clients authenticate with Authorization: Bearer <token>.

Generate a strong token with openssl rand -hex 32.

Tool catalog

Every read, search, and manage capability in the CLI is exposed as an MCP tool, so the CLI and your assistant work from the same data. The tools map closely to their CLI equivalents:

MCP tool	CLI equivalent
`bee_status`	`bee status`
`bee_search`	`bee search`
`bee_search_facts`	`bee facts search`
`bee_list_facts`	`bee facts list`
`bee_get_fact`	`bee facts get`
`bee_create_fact`	`bee facts create`
`bee_update_fact`	`bee facts update`
`bee_delete_fact`	`bee facts delete`
`bee_get_recent_activity`	`bee activity`
`bee_get_today`	`bee today`
`bee_list_conversations`	`bee conversations list`
`bee_get_conversation`	`bee conversations get`
`bee_get_conversation_transcript`	`bee conversations transcript`
`bee_get_related_conversations`	`bee conversations related`
`bee_get_daily_summary`	`bee daily get` / `bee daily find <YYYY-MM-DD>`
`bee_list_daily_summaries`	`bee daily list`
`bee_list_voice_notes`	`bee journals list`
`bee_search_voice_notes`	`bee journals search`
`bee_get_voice_note`	`bee journals get`
`bee_list_todos`	`bee todos list`
`bee_create_todo`	`bee todos create`
`bee_update_todo`	`bee todos update`
`bee_complete_todo`	`bee todos complete`
`bee_delete_todo`	`bee todos delete`
`bee_get_todo_suggestions`	`bee todos suggestions`
`bee_accept_todo_suggestion`	`bee todos accept-suggestion`
`bee_dismiss_todo_suggestion`	`bee todos dismiss-suggestion`
`bee_get_insights`	`bee insights list`
`bee_get_insight`	`bee insights get`
`bee_get_location_clusters`	`bee locations clusters`
`bee_get_recent_visits`	`bee locations recent`
`bee_get_current_location`	`bee locations current`
`bee_get_photos`	`bee photos list`
`bee_get_photo`	`bee photos get`

bee_search accepts query, limit, filter (all | conversations | daily | facts), sortBy (relevance | mostRecent), and mode (keyword | semantic), plus since and until (epoch milliseconds). The since/until time bounds apply in both keyword and semantic modes; filter and sortBy apply to keyword mode only.

MCP