Benzaiflow logo
Language
Back to home

MCP server

Bring Benzaiflow to the assistant you already use.

Benzaiflow has an MCP server, so another assistant — Claude, ChatGPT, or anything else that speaks MCP — can work with your tasks on your behalf. Capture a thought the moment it turns up, see what your day actually looks like, and start a focus session without leaving the conversation you were already in.

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.

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. In ChatGPT: Settings → Connectors, then add a connector by its URL.
  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.

Connect from Claude Code or a headless tool

Terminals, scripts, and background jobs cannot open a browser, so they use a connection key (a personal access token) instead.

  1. In the Benzaiflow app, go to Settings → Connections and tap New connection. 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: what is on now, what is waiting, and one to three things worth starting.
  • 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

Some assistants — claude.ai, ChatGPT, Copilot, Cursor — 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.