Workflowy

io.github.mholzen由 GitHub 帳號 mholzen 發布v0.8.1更新於 Nov 3, 2026

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

已驗證STDIO僅桌面效率與工作流知識與記憶

概覽

AI 產生的概覽

連接 AI 助理與 Workflowy 大綱的 MCP 伺服器兼 CLI，可讀取、搜尋、編輯節點並產生使用報告。

可以做什麼
  • 讀取與瀏覽大綱：取得節點樹、列出子孫節點、解析短 ID 與目標、依文字或正規表示式搜尋。
  • 建立、更新、移動、刪除節點，以及標記完成或未完成。
  • 以正規表示式批次尋找取代，支援試跑預覽。
  • 轉換節點內容：拆分、去除空白、去除標點，或透過 shell 指令處理。
  • 產生使用報告：節點數量、子節點數、最舊、久未修改與鏡像最多的節點。
適用情境
適合把筆記、任務或專案結構放在 Workflowy，並希望助理搜尋內容、清理整理、批次重新命名，或統計陳舊與過於龐大內容的情境。
執行需求
需在本機安裝 workflowy 執行檔（Homebrew、Scoop、Go install、預先編譯的執行檔或 Docker 映像），以 stdio 方式執行。需要 Workflowy API 金鑰，透過 WORKFLOWY_API_KEY 環境變數或使用者家目錄下的金鑰檔案提供。需要連線至 Workflowy 的網路；backup 資料方式另需啟用 Workflowy 的 Dropbox 備份。
安裝前請注意
API 金鑰可存取你的 Workflowy 帳號，請勿放入共用設定。寫入類工具可建立、更新、移動、刪除節點並進行批次取代；README 說明移除 expose-all 參數即可限制為唯讀工具，寫入根節點參數可限定寫入範圍。transform 工具會把節點內容交給任意 shell 指令處理，等於將內容送給該指令。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Workflowy，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

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.

[Go] [Homebrew] [MCP Compatible] [MIT License]

[圖片]

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 ~/.workflowyecho "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 deepworkflowy get
# Generate a report showing where most of your nodes areworkflowy 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

bash
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
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)

ToolDescription
workflowy_getGet a node and its descendants as a tree
workflowy_listList descendants as a flat list
workflowy_searchSearch nodes by text or regex
workflowy_targetsList shortcuts and system targets (inbox, etc.)
workflowy_idResolve short ID or target key to full UUID
workflowy_report_countFind where most of your content lives
workflowy_report_childrenFind nodes with many children
workflowy_report_createdFind oldest nodes
workflowy_report_modifiedFind stale, unmodified nodes
workflowy_report_mirrorsFind most mirrored nodes (requires backup)

Write Tools

ToolDescription
workflowy_createCreate new nodes
workflowy_updateUpdate node content
workflowy_moveMove node to a new parent
workflowy_deleteDelete nodes
workflowy_completeMark nodes complete
workflowy_uncompleteMark nodes incomplete
workflowy_replaceBulk find-and-replace with regex
workflowy_transformTransform 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 datesworkflowy 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 confirmationworkflowy replace --interactive "foo" "bar"
# Use regex capture groupsworkflowy replace "TASK-([0-9]+)" 'ISSUE-$1'

Some Common CRUD Operations

bash
# Add a task to your inboxworkflowy create "Buy groceries" --parent-id=inbox
# Change the name of an itemworkflowy update xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx --name "Project Plan v2"
# Move an item to a different parentworkflowy move <item-id> <new-parent-id>
# Mark a node as complete, using a short IDworkflowy complete https://workflowy.com/#/xxxxxxxxxxxx
# Resolve a short ID or target key to full UUIDworkflowy id inbox

Transform Content

bash
# Split a node's content by newlines into child nodesworkflowy transform <item-id> split -s "\n"
# Clean up textworkflowy transform <item-id> trimworkflowy 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:

MethodSpeedFreshnessOfflineBest For
--method=getMediumReal-timeNoSpecific items
--method=exportFast*1 min worst case (due to rate limiting)NoFull tree access
--method=backupFastestStaleYesBulk operations

*Cached after first fetch

Offline Mode with Dropbox Backup

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

bash
workflowy get --method=backupworkflowy 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-workflowyscoop install workflowy

Go Install

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

Download Binary

Download pre-built binaries from GitHub Releases.

Docker

bash
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.gitcd workflowygo 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 itemsworkflowy report modified --top-n 20
# Weekly cleanup: find oversized nodesworkflowy report count --threshold 0.05
# Find unnecessary mirrorsworkflowy report mirrors --top-n 20
# Bulk rename: update project prefixworkflowy replace "OLD-" "NEW-" --parent-id projects-folder-id
# Split pasted content into child nodesworkflowy transform <item-id> split -s "\n"

Contributing

Contributions welcome! See the Contributing Guide.

bash
# Development setupgit clone https://github.com/mholzen/workflowy.gitcd workflowygo 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

來源：README.md，提交 86e8cd5

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.8.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分