mcpField
M
Mcp Workflowy

Mcp Workflowy

Local
github.com/danield137Productivity28Updated 43w ago
Repository

About Mcp Workflowy

Workflowy MCP is an MCP server for Workflowy that lets AI assistants read and change Workflowy lists. It suits users who manage projects or notes in Workflowy and authenticates with a username and password.

Key features

  1. 01Search, list and create nodes
  2. 02Update node text or description
  3. 03Mark nodes complete or incomplete
  4. 04Username and password account authentication

Use cases

  1. 01Asking an AI assistant to gather notes on a project
  2. 02Suggesting next tasks from milestones stored in Workflowy

MCP support

This project is an MCP server that provides list_nodes, search_nodes, create_node, update_node and toggle_complete tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "workflowy": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-workflowy"
      ],
      "env": {
        "WORKFLOWY_USERNAME": "<WORKFLOWY_USERNAME>",
        "WORKFLOWY_PASSWORD": "<WORKFLOWY_PASSWORD>"
      }
    }
  }
}
Run commandnpx -y mcp-workflowy
Environment variables to set
WORKFLOWY_USERNAME
WORKFLOWY_PASSWORDSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-workflowy

Tools

5

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
parentIdstringNoID of the parent node to list children from. If omitted, returns root nodes.

Details

From the project README

Install with NPX in VS Code

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.

mcp-workflowy MCP server

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

NPM Version NPM Downloads

# Install the package globally
npm install -g mcp-workflowy

# Or use npx to run it directly
npx mcp-workflowy server start

Configuration

Create a .env file in your project directory with the following content:

WORKFLOWY_USERNAME=your_username_here
WORKFLOWY_PASSWORD=your_password_here

Alternatively, you can provide these credentials as environment variables when running the server.

Usage

Starting the Server
# If installed globally
mcp-workflowy server start

# Using npx
npx mcp-workflowy server start
Available Tools

This MCP server provides the following tools to interact with your Workflowy:

  1. list_nodes - Get a list of nodes from your Workflowy (root nodes or children of a specified node)
  2. search_nodes - Search for nodes by query text
  3. create_node - Create a new node in your Workflowy
  4. update_node - Modify an existing node's text or description
  5. toggle_complete - Mark a node as complete or incomplete

Integrating with AI Assistants

To use this MCP server with AI assistants (like ChatGPT):

  1. Start the MCP server as described above
  2. Connect your AI assistant to the MCP server (refer to your AI assistant's documentation)
  3. The AI assistant will now be able to read and manipulate your Workflowy lists

One-Click

Install with NPX in VS Code

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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.