Model Context Protocol (MCP) server for interacting with Workflowy, enabling AI assistants to read and manage your Workflowy lists programmatically.

Installation

NPM Global

npm install -g mcp-workflowy

NPX

npx mcp-workflowy server start

Available Tools

Tool	Description
list_nodes	Get a list of nodes from your Workflowy (root nodes or child items of a specified node)
search_nodes	Search nodes by query text
create_node	Create a new node in your Workflowy
update_node	Change the text or description of an existing node
toggle_complete	Mark a node as completed or incomplete

Features

• Integration with Workflowy with username/password authentication
• Full MCP compatibility
• Search, create, update, and mark nodes as completed/incomplete in Workflowy

Environment Variables

Required

• WORKFLOWY_USERNAME - Your Workflowy account username
• WORKFLOWY_PASSWORD - Your Workflowy account password

Usage Examples

Show my all my notes on project XYZ in workflowy

Review the codebase, mark all completed notes as completed

Given my milestones on workflowy for this project, suggest what my next task should be

Notes

Requires Node.js v18 or higher and a Workflowy account. Environment variables can be specified via a .env file or as environment variables when starting the server.