Workflowy

Create, update, complete nodes, search & replace with regex and dry run, usage reports, transforms

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Remote HTTP

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "workflowy": {
      "url": "https://workflowy.com"
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

Workflowy MCP Server & CLI

A feature-rich Model Context Protocol (MCP) server and Command Line Interface (CLI) for Workflowy written in Go. Connect your AI assistant (Claude, ChatGPT, etc.) to your Workflowy data or run commands from a terminal emulator or script, including search, bulk replace, usage reports, and offline access capabilities.

Why This Workflowy MCP Server?

Full-text search with regex
Bulk search & replace
Content transformation (split, clean, pipe to LLMs)
Usage reports (stale nodes, size analysis, mirrors)
Sandboxed AI access with --write-root-id
Offline mode via backup files
CLI + MCP server in one tool
Caching for performance
Homebrew installation
Basic CRUD operations
Using short IDs (Copy Internal Link)

Quick Start

Install via Homebrew

bash

brew install mholzen/workflowy/workflowy-cli

Configure Your API Key

bash

mkdir -p ~/.workflowy
echo "your-api-key-here" > ~/.workflowy/api.key

Get your API key at https://workflowy.com/api-key/

Run Your First Command

bash

# Get the top-level nodes, and nodes two levels deep
workflowy get

# Generate a report showing where most of your nodes are
workflowy report count | pbcopy   # paste directly into Workflowy!

Use pbcopy on macOS, clip on Windows, wl-copy on Linux, or xclip for X11 systems.

Use with Claude Desktop or Claude Code

Claude Code

Terminal

claude mcp add --transport=stdio workflowy -- workflowy mcp --expose=all

Remove —expose=all to limit to read-only tools.

Claude Desktop

Add to your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

config.json

{
  "mcpServers": {
    "workflowy": {
      "command": "workflowy",
      "args": ["mcp", "--expose=all"]
    }
  }
}

Restart Claude Desktop and start asking Claude to work with your Workflowy!

MCP Tools for AI Assistants

Read Tools (Safe)

Tool	Description
`workflowy_get`	Get a node and its descendants as a tree
`workflowy_list`	List descendants as a flat list
`workflowy_search`	Search nodes by text or regex
`workflowy_targets`	List shortcuts and system targets (inbox, etc.)
`workflowy_id`	Resolve short ID or target key to full UUID
`workflowy_report_count`	Find where most of your content lives
`workflowy_report_children`	Find nodes with many children
`workflowy_report_created`	Find oldest nodes
`workflowy_report_modified`	Find stale, unmodified nodes
`workflowy_report_mirrors`	Find most mirrored nodes (requires backup)

Write Tools

Tool	Description
`workflowy_create`	Create new nodes
`workflowy_update`	Update node content
`workflowy_move`	Move node to a new parent
`workflowy_delete`	Delete nodes
`workflowy_complete`	Mark nodes complete
`workflowy_uncomplete`	Mark nodes incomplete
`workflowy_replace`	Bulk find-and-replace with regex
`workflowy_transform`	Transform node content (split, trim, shell commands)

CLI Features

Search Your Entire Outline

bash

# Find all TODOs (case-insensitive)
workflowy search -i "foobar"

# Regex search for dates
workflowy search -E "<time.*>"

# Search within a specific subtree (using Internal Link)
workflowy search "bug" --item-id https://workflowy.com/#/1bdae4aecf00

Bulk Search and Replace

bash

# Preview changes first (dry run)
workflowy replace --dry-run "foo" "bar"

# Interactive confirmation
workflowy replace --interactive "foo" "bar"

# Use regex capture groups
workflowy replace "TASK-([0-9]+)" 'ISSUE-$1'

Some Common CRUD Operations

bash

# Add a task to your inbox
workflowy create "Buy groceries" --parent-id=inbox

# Change the name of an item
workflowy update xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --name "Project Plan v2"

# Move an item to a different parent
workflowy move <item-id> <new-parent-id>

# Mark a node as complete, using a short ID
workflowy complete https://workflowy.com/#/xxxxxxxxxxxx

# Resolve a short ID or target key to full UUID
workflowy id inbox

Transform Content

bash

# Split a node's content by newlines into child nodes
workflowy transform <item-id> split -s "\n"

# Clean up text
workflowy transform <item-id> trim
workflowy transform <item-id> no-punctuation

# Pipe content through any shell command (e.g., an LLM)
workflowy transform <item-id> -x 'echo {} | llm "summarize this"'

Usage Reports

bash

# Where is most of my content?
workflowy report count --threshold 0.01

# Which nodes have the most children?
workflowy report children --top-n 20

# Find stale content (oldest modified)
workflowy report modified --top-n 50

# Find most mirrored nodes (requires backup)
workflowy report mirrors --top-n 20

Data Access Methods

Choose the best method for your use case:

Method	Speed	Freshness	Offline	Best For
`--method=get`	Medium	Real-time	No	Specific items
`--method=export`	Fast*	1 min worst case (due to rate limiting)	No	Full tree access
`--method=backup`	Fastest	Stale	Yes	Bulk operations

*Cached after first fetch

Offline Mode with Dropbox Backup

Enable Workflowy's Dropbox backup and access your data offline:

bash

workflowy get --method=backup
workflowy search -i "project" --method=backup

Installation Options

Homebrew (macOS & Linux)

bash

brew install mholzen/workflowy/workflowy-cli

Scoop (Windows)

powershell

scoop bucket add workflowy https://github.com/mholzen/scoop-workflowy
scoop install workflowy

Go Install

bash

go install github.com/mholzen/workflowy/cmd/workflowy@latest

Download Binary

Download pre-built binaries from GitHub Releases.

Docker

Terminal

docker run --rm -e WORKFLOWY_API_KEY=your-key ghcr.io/mholzen/workflowy:latest get

From Source

bash

git clone https://github.com/mholzen/workflowy.git
cd workflowy
go build ./cmd/workflowy

Documentation

Examples

AI Assistant Workflows

Ask Claude:

"Search my Workflowy for all items containing 'meeting notes'"
"Show me nodes I haven't touched in 6 months"
"Replace all 'v1' with 'v2' in my Project A folder"
"What's taking up the most space in my outline?"
"Which nodes are mirrored the most?"
"Move this item to my inbox"

CLI Workflows

bash

# Morning review: find stale items
workflowy report modified --top-n 20

# Weekly cleanup: find oversized nodes
workflowy report count --threshold 0.05

# Find unnecessary mirrors
workflowy report mirrors --top-n 20

# Bulk rename: update project prefix
workflowy replace "OLD-" "NEW-" --parent-id projects-folder-id

# Split pasted content into child nodes
workflowy transform <item-id> split -s "\n"

Contributing

Contributions welcome! See the Contributing Guide.

bash

# Development setup
git clone https://github.com/mholzen/workflowy.git
cd workflowy
go test ./...

License

MIT — see LICENSE

Acknowledgments

Thanks to Andrew Lisy for requesting a method to sandbox write commands
Thanks to Craig P. Motlin for pointing out mirrors are defined in the backup files

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

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

Frequently Asked Questions about Workflowy

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "workflowy": { "command": "npx", "args": ["-y", "workflowy"] } }

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 Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/workflowy?style=directory)](https://allmcps.com/mcp/workflowy)

HTML Embed

<a href="https://allmcps.com/mcp/workflowy"><img src="https://allmcps.com/api/badge/workflowy?style=directory" alt="Workflowy on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

40Quality signal: Fair · 40/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity4/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Workflowy →Install in Claude Desktop Install in Cursor Install in VS Code

Workflowy

Create, update, complete nodes, search & replace with regex and dry run, usage reports, transforms

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Remote HTTP

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "workflowy": {
      "url": "https://workflowy.com"
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

Workflowy MCP Server & CLI

Why This Workflowy MCP Server?

Full-text search with regex
Bulk search & replace
Content transformation (split, clean, pipe to LLMs)
Usage reports (stale nodes, size analysis, mirrors)
Sandboxed AI access with --write-root-id
Offline mode via backup files
CLI + MCP server in one tool
Caching for performance
Homebrew installation
Basic CRUD operations
Using short IDs (Copy Internal Link)

Quick Start

Install via Homebrew

bash

brew install mholzen/workflowy/workflowy-cli

Configure Your API Key

bash

mkdir -p ~/.workflowy
echo "your-api-key-here" > ~/.workflowy/api.key

Get your API key at https://workflowy.com/api-key/

Run Your First Command

bash

# Get the top-level nodes, and nodes two levels deep
workflowy get

# Generate a report showing where most of your nodes are
workflowy report count | pbcopy   # paste directly into Workflowy!

Use pbcopy on macOS, clip on Windows, wl-copy on Linux, or xclip for X11 systems.

Use with Claude Desktop or Claude Code

Claude Code

Terminal

claude mcp add --transport=stdio workflowy -- workflowy mcp --expose=all

Remove —expose=all to limit to read-only tools.

Claude Desktop

Add to your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

config.json

{
  "mcpServers": {
    "workflowy": {
      "command": "workflowy",
      "args": ["mcp", "--expose=all"]
    }
  }
}

Restart Claude Desktop and start asking Claude to work with your Workflowy!

MCP Tools for AI Assistants

Read Tools (Safe)

Tool	Description
`workflowy_get`	Get a node and its descendants as a tree
`workflowy_list`	List descendants as a flat list
`workflowy_search`	Search nodes by text or regex
`workflowy_targets`	List shortcuts and system targets (inbox, etc.)
`workflowy_id`	Resolve short ID or target key to full UUID
`workflowy_report_count`	Find where most of your content lives
`workflowy_report_children`	Find nodes with many children
`workflowy_report_created`	Find oldest nodes
`workflowy_report_modified`	Find stale, unmodified nodes
`workflowy_report_mirrors`	Find most mirrored nodes (requires backup)

Write Tools

Tool	Description
`workflowy_create`	Create new nodes
`workflowy_update`	Update node content
`workflowy_move`	Move node to a new parent
`workflowy_delete`	Delete nodes
`workflowy_complete`	Mark nodes complete
`workflowy_uncomplete`	Mark nodes incomplete
`workflowy_replace`	Bulk find-and-replace with regex
`workflowy_transform`	Transform node content (split, trim, shell commands)

CLI Features

Search Your Entire Outline

bash

# Find all TODOs (case-insensitive)
workflowy search -i "foobar"

# Regex search for dates
workflowy search -E "<time.*>"

# Search within a specific subtree (using Internal Link)
workflowy search "bug" --item-id https://workflowy.com/#/1bdae4aecf00

Bulk Search and Replace

bash

# Preview changes first (dry run)
workflowy replace --dry-run "foo" "bar"

# Interactive confirmation
workflowy replace --interactive "foo" "bar"

# Use regex capture groups
workflowy replace "TASK-([0-9]+)" 'ISSUE-$1'

Some Common CRUD Operations

bash

# Add a task to your inbox
workflowy create "Buy groceries" --parent-id=inbox

# Change the name of an item
workflowy update xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --name "Project Plan v2"

# Move an item to a different parent
workflowy move <item-id> <new-parent-id>

# Mark a node as complete, using a short ID
workflowy complete https://workflowy.com/#/xxxxxxxxxxxx

# Resolve a short ID or target key to full UUID
workflowy id inbox

Transform Content

bash

# Split a node's content by newlines into child nodes
workflowy transform <item-id> split -s "\n"

# Clean up text
workflowy transform <item-id> trim
workflowy transform <item-id> no-punctuation

# Pipe content through any shell command (e.g., an LLM)
workflowy transform <item-id> -x 'echo {} | llm "summarize this"'

Usage Reports

bash

# Where is most of my content?
workflowy report count --threshold 0.01

# Which nodes have the most children?
workflowy report children --top-n 20

# Find stale content (oldest modified)
workflowy report modified --top-n 50

# Find most mirrored nodes (requires backup)
workflowy report mirrors --top-n 20

Data Access Methods

Choose the best method for your use case:

Method	Speed	Freshness	Offline	Best For
`--method=get`	Medium	Real-time	No	Specific items
`--method=export`	Fast*	1 min worst case (due to rate limiting)	No	Full tree access
`--method=backup`	Fastest	Stale	Yes	Bulk operations

*Cached after first fetch

Offline Mode with Dropbox Backup

Enable Workflowy's Dropbox backup and access your data offline:

bash

workflowy get --method=backup
workflowy search -i "project" --method=backup

Installation Options

Homebrew (macOS & Linux)

bash

brew install mholzen/workflowy/workflowy-cli

Scoop (Windows)

powershell

scoop bucket add workflowy https://github.com/mholzen/scoop-workflowy
scoop install workflowy

Go Install

bash

go install github.com/mholzen/workflowy/cmd/workflowy@latest

Download Binary

Download pre-built binaries from GitHub Releases.

Docker

Terminal

docker run --rm -e WORKFLOWY_API_KEY=your-key ghcr.io/mholzen/workflowy:latest get

From Source

bash

git clone https://github.com/mholzen/workflowy.git
cd workflowy
go build ./cmd/workflowy

Documentation

Examples

AI Assistant Workflows

Ask Claude:

"Search my Workflowy for all items containing 'meeting notes'"
"Show me nodes I haven't touched in 6 months"
"Replace all 'v1' with 'v2' in my Project A folder"
"What's taking up the most space in my outline?"
"Which nodes are mirrored the most?"
"Move this item to my inbox"

CLI Workflows

bash

# Morning review: find stale items
workflowy report modified --top-n 20

# Weekly cleanup: find oversized nodes
workflowy report count --threshold 0.05

# Find unnecessary mirrors
workflowy report mirrors --top-n 20

# Bulk rename: update project prefix
workflowy replace "OLD-" "NEW-" --parent-id projects-folder-id

# Split pasted content into child nodes
workflowy transform <item-id> split -s "\n"

Contributing

Contributions welcome! See the Contributing Guide.

bash

# Development setup
git clone https://github.com/mholzen/workflowy.git
cd workflowy
go test ./...

License

MIT — see LICENSE

Acknowledgments

Thanks to Andrew Lisy for requesting a method to sandbox write commands
Thanks to Craig P. Motlin for pointing out mirrors are defined in the backup files

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

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

Frequently Asked Questions about Workflowy

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "workflowy": { "command": "npx", "args": ["-y", "workflowy"] } }

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 Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/workflowy?style=directory)](https://allmcps.com/mcp/workflowy)

HTML Embed

<a href="https://allmcps.com/mcp/workflowy"><img src="https://allmcps.com/api/badge/workflowy?style=directory" alt="Workflowy on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

40Quality signal: Fair · 40/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity4/15

Community engagement0/10

★ Featured

AllMCPs Server

Explore Server →

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Workflowy →Install in Claude Desktop Install in Cursor Install in VS Code