Benzaiflow logo
Language
Back to home

MCP server

Keep the thread, even when you change assistants.

Save the thought that interrupts you. Find one doable next step. Leave a project ready to pick up tomorrow. Connect your assistant to the same tasks, pond and project notes you use in Benzaiflow — through MCP.

Server address

https://api.benzaiflow.com/mcp

One address for everything below. Your assistant connects to it directly — nothing to install, nothing to keep running on your machine.

Three ways to use it today

Catch a distraction

Save this in Benzaiflow: ask the landlord about the boiler. Then let’s get back to what we were doing.

One thought saved in your pond. No organizing interview. Permission: Capture thoughts.

Find a way in

Use Benzaiflow to find one thing I can do in 15 minutes with low energy. Show me why it fits. Don’t change anything yet.

Start with a read of your real plan. Permission: See your plan.

Leave a way back

Save our progress on my Kitchen project in Benzaiflow: what we finished, what’s still blocked, and one next step. Use an existing task if it’s already there.

Next conversation: “Pick up where I left off on Kitchen.” Permission: Projects.

Using Claude Code or Codex?

Run the commands for your assistant, then approve the permissions in your browser. No access key to paste.

Claude Code

claude mcp add --transport http --scope user benzaiflow \
  https://api.benzaiflow.com/mcp

Then open Claude Code, run /mcp, choose benzaiflow and sign in.

Codex

codex mcp add benzaiflow \
  --url https://api.benzaiflow.com/mcp
codex mcp login benzaiflow

The second command opens browser sign-in. Reopen your assistant session if the tools have not appeared.

Start with See your plan to try a read. Add Capture thoughts and task updates for everyday use, or Projects to keep a session trail. Memory and profile access are optional.

Connect from Claude or ChatGPT

If your assistant can open a browser, this is the whole setup. No token to copy, nothing to paste twice.

  1. In claude.ai: Settings → Connectors, then Add custom connector (direct link: claude.ai/customize/connectors).
  2. For ChatGPT or another host, check its current custom MCP app setup guide. Availability depends on your account and workspace; this is a custom server, not a listed app.
  3. Paste the server address above.
  4. A browser window opens. Sign in to Benzaiflow and tick what this assistant is allowed to do.
  5. That is it. The connection stays until you remove it.

You need a full Benzaiflow account for this, not a guest one — signing in with Apple, Google, or your email is enough. Menus move around: if the wording differs, look for connectors, apps, or MCP servers in your assistant's settings. On team or enterprise plans, an admin may have to add it for everyone.

Advanced: tools without browser sign-in

Use an access key only when your tool cannot complete browser sign-in. Interactive Claude Code and Codex support the browser setup above.

  1. In the Benzaiflow app, go to Settings → Connections and tap New access key. You choose what it is allowed to do while you are there.
  2. Copy the key straight away — it is shown once, and only a hash of it is kept.
  3. Add the server to Claude Code with the command below.

Add it to Claude Code

claude mcp add --transport http benzaiflow \
  https://api.benzaiflow.com/mcp \
  --header "Authorization: Bearer <your token>"

One thing worth knowing

If the header is rejected, Claude Code reports the connection as failed rather than falling back to browser sign-in. It will keep failing until you remove the header from your configuration — remove it, and the browser flow takes over.

Connections expire after 90 days by default, and you can disconnect any of them from the same screen.

What your assistant can do

You choose this list when you connect, one line at a time. Anything you leave out simply is not there — the assistant cannot reach it, and it cannot grant itself more later.

  • captureDrop a thought straight into your pond, in your own words. Benzaiflow shapes it into a task later.
  • plan:readSee today, find tasks by name and read their saved notes and steps. Get one to three suggestions that fit your capacity.
  • tasks:writeTick something off, push it to later without guilt, break a big thing into smaller ones, or put it on the calendar.
  • focusStart and end a focus session — the same timer that runs on your phone and lock screen.
  • projectsPick a project back up after time away, leave a note about what happened, or park one without giving up on it.
  • memoryRemember how you work — a preference, a pattern, a constraint — and bring it back when it matters.
  • profile:readRead your working-style profile, so the assistant adapts instead of guessing. This is the most personal one, which is why it stands on its own line.

You can disconnect at any time, from the app or from the assistant.

Cards, not walls of text

Hosts that support MCP Apps can render Benzaiflow's answers as small interactive cards: your day, your suggestions, and a live focus timer you can tap. Where that is not supported, the same answers arrive as plain text and nothing breaks.

How this is kept safe

Every connection belongs to one account and carries only the permissions you approved. Tokens are stored hashed, never in plain text, and they work against this one address only — they cannot be used anywhere else in Benzaiflow. Nothing is shared with an assistant beyond what you said yes to, and you can take that back at any moment.