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 分