# WorkFlow Companion

> WorkFlow Companion is an open-source MCP server for productivity. Lets Claude on Windows or Linux work in your WorkFlow tasks, notes and projects via iCloud. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Windows, Linux, CLI
- **Website:** https://www.opticell-limited.com/companion
- **Repository:** https://github.com/teamdzx/workflow-companion
- **MCP Registry name:** io.github.TeamDzX/workflow-companion
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "workflow-companion": {
      "command": "npx",
      "args": [
        "-y",
        "@opticell/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

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/workflow-companion
