Dynalist

You run a Dynalist MCP Server that lets Claude and other AI assistants read, write, and manipulate your Dynalist documents through a programmable API. It exposes a set of read, write, and structure operations that you can call from your MCP client to automate document management and workflows.

How to use

You access the Dynalist MCP server by running it locally and connecting your MCP client to the stdio endpoint. The server supports a comprehensive set of read, write, and structure operations that you can invoke from your client to manage documents, read content as Markdown, and perform bulk imports.

How to install

Prerequisites: Node.js is required to build and run the MCP server.

Install dependencies and build the server.

npm install
npm run build

Configure the MCP server for your client

Set up your client to connect to the Dynalist MCP server using the stdio runtime. The server is started with Node and you point to the built entry script. You also provide your Dynalist API token as an environment variable.

{
  "mcpServers": {
    "dynalist": {
      "command": "node",
      "args": ["/FULL/PATH/TO/dynalist-mcp/dist/index.js"],
      "env": {
        "DYNALIST_API_TOKEN": "your_token_here"
      }
    }
  }
}

What you can do with the Dynalist MCP server

The server exposes actions organized into three groups: Read Operations, Write Operations, and Structure Operations. You can list documents, search and read content, add items to your inbox, edit or insert nodes, bulk import from Markdown, and reorganize hierarchy by moving nodes.

Key capabilities include reading documents and nodes, extracting content as Markdown with preserved hierarchy, bulk inserting from Markdown, and manipulating the Dynalist tree by moving or deleting nodes.

Available tools

list_documents

List all documents and folders in your Dynalist account.

search_documents

Search documents or folders by name and return IDs, URLs, and types.

read_node_as_markdown

Extract a node and its subtree as Markdown, preserving hierarchy and notes.

search_in_document

Search content within a document and return matching nodes with optional parent/child context.

get_recent_changes

Fetch nodes created or modified within a time window, with parent context.

send_to_inbox

Add items to your Dynalist inbox, with hierarchical structure available in Markdown.

edit_node

Modify node content, notes, checkboxes, headings, and colors.

insert_node

Insert a single new node at a specified location.

insert_nodes_from_markdown

Bulk import nodes from indented Markdown or bullet lists.

delete_node

Remove a node, with an option to remove all its children.

move_node

Move a node to a new parent and index.

move_node_relative

Move a node and its subtree relative to another node (after/before/as_child).