Skip to content
MCP server

WorkFlow Companion

Lets Claude on Windows or Linux work in your WorkFlow tasks, notes and projects via iCloud

Runs locallyStatus and history
Pricing
Open source
Platforms
Windows, Linux, CLI
Runs
Locally
Version
2.7.0
Listing updated
3 days ago

About WorkFlow Companion

WorkFlow Companion is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

WorkFlow runs on Apple devices, so this companion bridges the gap for people whose Claude runs elsewhere. Claude can read the task queue, reply in threads, tick checklists, file notes and update documents. The README points Mac users to a separate open-source bridge instead.

The companion never edits WorkFlow data itself. It leaves commands in a zone of your own private iCloud database, and WorkFlow on an iPhone, iPad or Mac applies them with the app's usual checks and lists each one in Command History. Nothing passes through Opticell's servers. A Mac with WorkFlow open answers within seconds, while an iPhone or iPad answers when iOS lets the app run, sometimes only when next opened.

It needs WorkFlow 5.2 or later and Node.js 18 or later. A one-line installer for PowerShell or a shell signs in and registers it with Claude Code, and a WorkFlow.mcpb bundle is offered for Claude Desktop.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "workflow-companion": {
      "command": "npx",
      "args": [
        "-y",
        "@opticell/workflow-companion"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "workflow-companion": {
      "command": "npx",
      "args": [
        "-y",
        "@opticell/workflow-companion"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "workflow-companion": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@opticell/workflow-companion"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "workflow-companion": {
      "command": "npx",
      "args": [
        "-y",
        "@opticell/workflow-companion"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "workflow-companion": {
      "command": "npx",
      "args": [
        "-y",
        "@opticell/workflow-companion"
      ]
    }
  }
}

What it does

Task and note access
Read the queue, file notes and update documents in WorkFlow.
Threads and checklists
Reply in task threads and tick checklist items.
iCloud command channel
Commands travel through your own private iCloud database, not Opticell servers.
Command History
WorkFlow lists every applied command for review.
One-line installer
PowerShell and shell scripts install Node.js if needed and add the server to Claude Code.
Claude Desktop bundle
An mcpb bundle is available from the Releases page.

Good for

  • Triage your WorkFlow task queue from Claude on a Windows PC
  • Tick off a checklist after finishing work
  • File meeting notes into a project
  • Reply to a task thread without opening the app

Pricing

Open source

Free; MIT licensed

Prices change. Check opticell-limited.com before you buy.

WorkFlow Companion FAQ

What do I need on the Apple side?

WorkFlow 5.2 or later on an iPhone, iPad or Mac, with the companion switched on in its settings.

Does my data go through Opticell?

No. The README says nothing passes through Opticell's servers; commands go through your private iCloud.

How fast does it respond?

A Mac with WorkFlow open answers within seconds. An iPhone or iPad usually answers within minutes.

Is it free?

Yes, and the source is MIT licensed.

Is WorkFlow Companion free?

Yes. WorkFlow Companion is open source, so you can use and self-host it for free.

How do I add WorkFlow Companion to Claude Code?

Run this command in your terminal: claude mcp add workflow-companion -- npx -y @opticell/workflow-companion

What are the best alternatives to WorkFlow Companion?

The closest alternatives to WorkFlow Companion are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to WorkFlow Companion

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media