workflowyMCP

An MCP server and CLI tool that uses Workflowy and Claude to create CONCEPT Maps and manage Tasks

Installation

Run this command in your terminal to add the MCP server to Claude Code.

Run in terminal:

Command

claude mcp add --transport stdio dromologue-workflowymcp node /absolute/path/to/workflowyMCP/dist/index.js \
  --env DROPBOX_APP_KEY="optional-dropbox-app-key" \
  --env ANTHROPIC_API_KEY="optional-anthropic-api-key" \
  --env WORKFLOWY_API_KEY="your-workflowy-api-key" \
  --env DROPBOX_APP_SECRET="optional-dropbox-app-secret" \
  --env DROPBOX_REFRESH_TOKEN="optional-dropbox-refresh-token"

How to use

This MCP server exposes a suite of tools for working with Workflowy via Claude. Once running, Claude Desktop or Claude Code can invoke tools to search, navigate, create and edit nodes, and generate concept maps or task maps from your Workflowy outline. The server supports actions like searching for nodes by text or tags, inserting and updating content, moving or deleting nodes, and rendering interactive concept maps or task maps from your data. In Claude Code, use the dedicated commands to generate concept maps and task maps, or call individual tools to inspect and modify your Workflowy structure through natural language prompts.

How to install

Prerequisites:

Node.js (recommended: LTS version, 14+)
npm (bundled with Node.js)
Git

Install steps:

Clone the repository git clone https://github.com/dromologue/workflowyMCP.git
Install dependencies cd workflowyMCP npm install
Build the project npm run build
Prepare environment variables (required and optional):
- Required: WORKFLOWY_API_KEY (get from workflowy.com/api-key)
- Optional: ANTHROPIC_API_KEY for --auto concept map analysis
- Optional: Dropbox credentials for cloud-hosted maps (see README): DROPBOX_APP_KEY, DROPBOX_APP_SECRET, DROPBOX_REFRESH_TOKEN
Start the MCP server (configured for Claude Desktop/Code integration) Ensure the path to the built dist/index.js is correct in your environment and run the server using the MCP runner configuration.

Additional notes

Tips and notes:

Set WORKFLOWY_API_KEY in a .env or through your environment; without it the server cannot access Workflowy.
If you plan to use automatic concept map analysis, provide ANTHROPIC_API_KEY to enable --auto mode.
If you enable Dropbox integration, ensure the app keys and refresh token are valid and that Dropbox permissions include files.content.write and sharing.write.
For Claude Desktop, configure the mcpServers entry with the absolute path to dist/index.js as shown in the README example.
Development workflow: you can run npm run mcp:dev to build and start the server in development mode with live changes.
If you encounter port or binding issues, verify no other process is occupying the port used by your MCP runner and confirm the server has network access to Workflowy and any external services (Dropbox, Anthropic).

Related MCP Servers

obsidian -tools

612

Add Obsidian integrations like semantic search and custom Templater prompts to Claude or any MCP client.

mcp

Octopus Deploy Official MCP Server

furi

CLI & API for MCP management

mcp -arangodb

This is a TypeScript-based MCP server that provides database interaction capabilities through ArangoDB. It implements core database operations and allows seamless integration with ArangoDB through MCP tools. You can use it wih Claude app and also extension for VSCode that works with mcp like Cline!

CodeRAG

Advanced graph-based code analysis for AI-assisted software development

mcp-bundler

Is the MCP configuration too complicated? You can easily share your own simplified setup!