Build AI agents with the Workflowy API

Use the Workflowy API directly when you need a custom agent, integration, or automation.

View as Markdown

The Workflowy API gives your code direct access to Workflowy nodes. Use it when an existing MCP or CLI connector does not fit your product, hosting, authentication, or workflow requirements.

What you can build

  • An agent that captures research or meeting notes into a chosen Workflowy location
  • A workflow that reads a project area and summarizes open work
  • An integration that creates, retrieves, lists, updates, moves, completes, or deletes nodes
  • A hosted service that uses Workflowy as a structured workspace
  • An export or backup workflow that preserves Workflowy's node hierarchy

Get started

  1. Get a key from workflowy.com/api-key.
  2. Open the Workflowy API reference.
  3. Follow a guide or choose the endpoint for the operation you need.
  4. Authenticate requests with your API key.
  5. Test reads and narrowly scoped writes before allowing an agent to make broader changes.

Send the key as a bearer token in the Authorization header. Do not put it in URLs, source control, chat messages, or client-side code that other people can inspect.

The API reference documents the request and response format for each endpoint. Handle non-success responses explicitly and stay within the rate limit shown for the operation you use.

Design agents for safe changes

AI agents can make mistakes. Give them the smallest useful scope, require confirmation for destructive actions, preserve stable node IDs, and verify important writes after they happen.

For non-AI apps and automations, start with the Integrations overview.