
WorkFlow Companion
Lets Claude on Windows or Linux work in your WorkFlow tasks, notes and projects via iCloud
- 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-companionAdd to claude_desktop_config.json
{
"mcpServers": {
"workflow-companion": {
"command": "npx",
"args": [
"-y",
"@opticell/workflow-companion"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"workflow-companion": {
"command": "npx",
"args": [
"-y",
"@opticell/workflow-companion"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media