Integrations
Supports loading environment variables from a .env file for storing Workflowy credentials.
Required runtime environment for the MCP server (v18 or higher).
Used for installation and package management of the MCP server.
Workflowy MCP
A Model Context Protocol (MCP) server for interacting with Workflowy. This server provides an MCP-compatible interface to Workflowy, allowing AI assistants to interact with your Workflowy lists programmatically.
What is MCP?
The Model Context Protocol (MCP) is a standardized way for AI models to interact with external tools and APIs. This server implements MCP to allow AI assistants (like ChatGPT) to read and manipulate your Workflowy lists through a set of defined tools.
Features
- Workflowy Integration: Connect to your Workflowy account using username/password authentication
- MCP Compatibility: Full support for the Model Context Protocol
- Tool Operations: Search, create, update, and mark nodes as complete/incomplete in your Workflowy
Example Usage:
Personally, I use workflowy as my project management tool. Giving my agent access to my notes, and my code base, the following are useful prompts:
- "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"
Installation
Prerequisites
- Node.js v18 or higher
- A Workflowy account
Quick Install
Configuration
Create a .env
file in your project directory with the following content:
Alternatively, you can provide these credentials as environment variables when running the server.
Usage
Starting the Server
Available Tools
This MCP server provides the following tools to interact with your Workflowy:
- list_nodes - Get a list of nodes from your Workflowy (root nodes or children of a specified node)
- search_nodes - Search for nodes by query text
- create_node - Create a new node in your Workflowy
- update_node - Modify an existing node's text or description
- toggle_complete - Mark a node as complete or incomplete
Integrating with AI Assistants
To use this MCP server with AI assistants (like ChatGPT):
- Start the MCP server as described above
- Connect your AI assistant to the MCP server (refer to your AI assistant's documentation)
- The AI assistant will now be able to read and manipulate your Workflowy lists
One-Click
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.
You must be authenticated.
mcp-workflowy
- What is MCP?
- Features
- Example Usage:
- Installation
- Configuration
- Usage
- Integrating with AI Assistants
- One-Click
- Contributing
- License
Related Resources
Related MCP Servers
- PythonApache 2.0
- Apache 2.0
- TypeScriptMIT License
- PythonMIT License