WorkFlow Companion MCP server

WorkFlow Companion

This repository is where WorkFlow Companion is released and supported:

downloads (WorkFlow.mcpb for Claude Desktop) are on the

Releases page,

and bugs and requests go in Issues.

The package itself installs from npm. On a Mac, use the open-source

workflow-agent-bridge instead.

All of Opticell's free tools for Claude: opticell-mcp.

Lets Claude on Windows or Linux work in your WorkFlow tasks, notes and projects: reading the queue, replying in threads, ticking checklists, filing notes, updating documents. It works in Claude Code, Claude Desktop, or any MCP client.

Free. It needs WorkFlow 5.2 or later on an iPhone, iPad or Mac, which does the actual work. No Mac needed:

Claude ──MCP──▶ companion ──▶ your private iCloud ──▶ WorkFlow on your iPhone, iPad or Mac
                                                  ◀── receipt + fresh snapshot

The companion never edits your WorkFlow data itself. It leaves commands in a zone of your own private iCloud database. WorkFlow applies them with the same checks as the app (read-only trial gate, email permission, the agent's signature) and lists every one in Command History. Nothing passes through Opticell's servers.

Which device answers. A Mac with WorkFlow open answers within seconds. An iPhone or iPad answers when iOS lets WorkFlow run: usually within minutes, sometimes only when you next open it, and not while WorkFlow has been swiped away in the app switcher. With both switched on, the Mac answers while it's awake and the iPhone stands by. Every command is applied exactly once, however many devices are on.

Set up

the Companion. On a Mac: Settings → Agent Bridge, then the Agent Bridge and Cloud Bridge** switches.

1. In WorkFlow on an iPhone or iPad: **Settings → Windows Companion → Answer

1. On this computer, with Node 18 or later:

npx -y @opticell/workflow-companion setup

It opens to sign in with the Apple Account WorkFlow uses on your iPhone or Mac, then asks you to paste the token that page shows.

1. Add it to Claude:

claude mcp add --scope user workflow -- npx -y @opticell/workflow-companion

--scope user makes it available in every project on this computer.

Claude Desktop needs no terminal. Download WorkFlow.mcpb from the product page and double-click it. Then sign in at and paste the token into Settings → Extensions → WorkFlow Companion → Sign-in token.

Check it any time with npx -y @opticell/workflow-companion status.

Its name

Setup asks what Claude on this computer should be called in WorkFlow ("Companion" unless you choose, e.g. --name Server). That name is how work reaches it rather than the Mac's own Claude:

Shortened. The full README is on GitHub.