Dart MCP Server

How to use

You use the MCP server by starting either the local MCP server via npx or by running the Docker-based variant, then pointing your Dart MCP client at the local server. Once running, your client can access a set of prompts and tools to manage tasks and documents in Dart, including creating tasks, creating docs, and summarizing tasks. The MCP server exposes actions through the client’s configured server and returns structured results, which your AI assistant can interpret to perform common Dart work seamlessly.

How to install

Prerequisites: ensure you have Node.js installed so you can use npx, and have your Dart authentication token ready.

1) Install and run the MCP server using npx. This uses a hosted Dart MCP server image via npx and requires your token.

{
  "mcpServers": {
    "Dart": {
      "command": "npx",
      "args": ["-y", "dart-mcp-server@latest"],
      "env": {
        "DART_TOKEN": "dsa_..."
      }
    }
  }
}

Variant: setup with Docker

If you prefer Docker, you can run the MCP server in a container. The Docker variant uses the same token to authorize the server.

{
  "mcpServers": {
    "Dart": {
      "command": "bash",
      "args": [
        "-c",
        "docker rm -f dart-mcp >/dev/null 2>&1 || true; docker run -i --rm --name dart-mcp -e DART_TOKEN mcp/dart"
      ],
      "env": {
        "DART_TOKEN": "dsa_..."
      }
    }
  }
}

Notes on setup and tokens

Copy your authentication token from your Dart profile and place it in the MCP configuration under DART_TOKEN. If you are using a local Docker setup, ensure Docker is installed and accessible from your host.

Troubleshooting and tips

If the MCP server does not start, verify that your token is correct and that the chosen port (if any) is not blocked by a firewall. For Docker users, check container logs to diagnose startup issues. If you switch between the npx and Docker methods, ensure you are not running multiple instances with the same container name.

Tools and prompts available

Prompts include creating tasks, creating docs, and summarizing tasks. The available tools allow you to fetch and update task and document data, manage task comments, and navigate your Dart space configuration.

Security and environment

Treat the DART_TOKEN like a sensitive secret. Do not commit it to version control and only load it into your MCP setup through a secure environment variable mechanism.

Examples of MCP commands you can run

# Start the MCP server via npm/npx
npx -y dart-mcp-server@latest

# Or start via Docker (if you use the docker variant)
docker run -i --rm --name dart-mcp -e DART_TOKEN mcp/dart

get_config

Fetch information about your workspace, including assignees, boards, folders, statuses, tags, priorities, and sizes.

list_tasks

List tasks with optional filters such as assignee, status, board, priority, and due date.

create_task

Create a new task with title, description, status, priority, size, dates, board, assignees, tags, and a possible parent task.

get_task

Retrieve a specific task by its ID.

update_task

Update the properties of an existing task.

delete_task

Move a task to the trash so it can be recovered later.

add_task_comment

Add a comment to an existing task.

list_docs

List documents with optional filters such as folder, title, or content.

create_doc

Create a new document with a title, content, and folder.

get_doc

Retrieve a document by its ID.

update_doc

Update document properties.

delete_doc

Move a doc to the trash (recoverable).