Log inSubmit server
WorkFlow Companion logo

WorkFlow Companion

Connects Claude on Windows or Linux to WorkFlow tasks, notes, projects, documents, and approvals through private iCloud.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install WorkFlow Companion

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "workflow-companion": {
      "command": "npx",
      "args": [
        "-y",
        "@opticell/workflow-companion@latest"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

WorkFlow Companion MCP server lets Claude on Windows or Linux read and update WorkFlow tasks, notes, projects, and documents through the user's private iCloud. It places commands in iCloud for WorkFlow on an iPhone, iPad, or Mac to apply, with the app's checks and command history. Use it when Claude needs to participate in WorkFlow without a Mac on the same computer, including queue-based unattended work. The package supports Claude Code, Claude Desktop, and MCP clients using its standard MCP connection.

Use cases

  • Review and respond to assigned WorkFlow tasks
  • Search projects, notes, comments, and document contents
  • Create tasks and update checklists or status lines
  • Prepare email drafts for user approval
  • Monitor files, services, websites, or disk space

Key features

  • Task, note, project, document, and comment access
  • Private iCloud command bridge
  • User-approved proposals and local command approvals
  • Scheduled queue processing with Claude Code
  • WorkFlow watches and computer monitors
  • Document attachments, downloads, and version updates

Tools18

What WorkFlow Companion lets your agent do. Expand a tool for its parameters.

Verified live~3.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

8/8 checks healthy over the last 28d

What it can do

From the 18 tools this server returned when we ran it; 4 declare their own safety hints.

Can delete or modify data · 4Writes files · 1Makes network requests · 3Read-only tools · 13
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age23 days
Maintainers1

Observed 2026-10-28 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · @opticell/workflow-companion@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads3.4kPackage downloads in the last 30 days.
Last commit3d agoMost recent push to the default branch.
Tools exposed18Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How WorkFlow Companion works

What WorkFlow Companion does

WorkFlow Companion connects Claude running on Windows or Linux with WorkFlow data held in the user's private iCloud. It covers task queues, notes, projects, documents, comments, checklists, watches, monitors, approval requests, proposed changes, and draft email preparation. The companion can read information, create or update selected WorkFlow records, post replies, attach or download files, and prepare email drafts for user review.

The companion is intended for WorkFlow users who want Claude to participate in their existing workplace workflow. It can act on tasks assigned to the configured companion name, comments that mention that name, notes addressed to it, and due watches. Work intended for another assistant is excluded from its queue.

How it works

Claude communicates with the companion over MCP. The companion does not directly edit WorkFlow records. Instead, it writes commands into a private iCloud database, where WorkFlow on an iPhone, iPad, or Mac applies them using the app's permission and safety checks. WorkFlow returns receipts and a refreshed snapshot, and records commands in Command History.

A Mac with WorkFlow open can answer within seconds. iPhone and iPad responses depend on when iOS lets WorkFlow run and may wait until the app is opened; WorkFlow must not have been swiped away. With multiple devices enabled, each command is applied once.

Optional wake-on operation checks the companion's queue every two minutes and starts a Claude Code session for new work. Sessions run one at a time, have a configurable time limit, and can be restricted to WorkFlow tools. File, website, port, disk, and process monitors can wake the agent when a monitored condition changes.

Setup and configuration

WorkFlow 5.2 or newer must be enabled on an iPhone, iPad, or Mac. On iOS, enable Settings → Windows Companion → Answer the Companion. On macOS, enable the Agent Bridge and Cloud Bridge switches under Settings → Agent Bridge.

Install Node.js 18 or later, then run the package setup command from a normal interactive terminal:

Terminal
npx -y @opticell/workflow-companion@latest setup

Setup opens a sign-in page for the Apple Account used by WorkFlow and asks for the resulting token. Non-interactive shells can provide the token and companion name as command-line options. The companion is then registered with Claude Code using claude mcp add; Windows requires cmd /c before npx. Claude Desktop users can install the WorkFlow.mcpb download and enter the sign-in token in the extension settings.

Setup assigns a name, normally Companion, which determines how tasks and mentions reach this computer. Use status to inspect connectivity and snapshot freshness, and doctor for an end-to-end diagnostic. Wake-on operation can be enabled with wake-on and stopped with wake-off.

Tools and capabilities

The MCP tools include:

  • workflow_state for connectivity checks, version details, snapshot age, and diagnostics.
  • workflow_queue, workflow_list, and workflow_get for inboxes, searches, records, threads, profiles, folders, versions, and document text.
  • workflow_create_task, workflow_update_task, workflow_comment, and workflow_note for task, comment, checklist, and Notepad work.
  • workflow_create_project, workflow_attach, workflow_download, and workflow_update_document for projects and files.
  • workflow_draft_email for attaching an email draft that the user reviews and sends.
  • workflow_watch, workflow_monitor, and workflow_brief for deferred checks, local condition monitoring, and daily briefs.
  • workflow_propose for changes that require the user's Apply or Decline decision, including every delete.
  • workflow_approval for commands that must be approved before running on the local computer.

Limitations and notes

WorkFlow performs the actual changes, so device availability affects response time. Watches, briefs, proposals, downloads, and some other features require specified WorkFlow versions: watches require 5.4 or later, while downloads and briefs require 5.6 or later. Email drafting is governed by WorkFlow's Agent Bridge email setting and does not send mail directly unless the relevant permission is configured.

Wake-on is local automation, not a hosted service. On Windows, its scheduled task normally runs only while the user is logged in. Granting Claude Code access to shell tools can allow anyone who can mention the companion in WorkFlow to run commands on that computer, so that option requires deliberate configuration. The package is MIT licensed, and its source and release downloads are hosted on GitHub.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about WorkFlow Companion

WorkFlow Companion is an MCP server that connects Claude on Windows or Linux to WorkFlow through the user's private iCloud. Its main tools read and search tasks, notes, projects, documents, and comments, then create or update records, post replies, manage files, prepare email drafts, and handle watches, proposals, and approvals.

Install Node.js 18 or later, enable the companion bridge in WorkFlow, and run `npx -y @opticell/workflow-companion@latest setup` from an interactive terminal. Sign in with the Apple Account used by WorkFlow, then register the MCP server with Claude Code or install the WorkFlow.mcpb package for Claude Desktop.

Yes, WorkFlow Companion works with Claude Desktop. Download the WorkFlow.mcpb package, double-click it, then enter the sign-in token under Settings → Extensions → WorkFlow Companion. The companion name can also be configured in the extension settings.

Yes, it can start Claude Code sessions for new assigned work when wake-on is enabled. A scheduled job checks the companion queue every two minutes, processes one session at a time, and posts progress in the WorkFlow thread. By default, those sessions are limited to WorkFlow tools.

No, its email tool prepares a draft attached to the task for the user to review and send. WorkFlow controls whether drafting is allowed through Settings → Agent Bridge → Email, with Draft Only or Can Send options governing the permission.

Related MCP servers

All in Knowledge & Memory All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewWorkFlow Companion AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/workflow-companion?style=directory)](https://allmcps.com/mcp/workflow-companion)
HTML Embed
<a href="https://allmcps.com/mcp/workflow-companion"><img src="https://allmcps.com/api/badge/workflow-companion?style=directory" alt="WorkFlow Companion on AllMCPs" /></a>