Dart MCP Server

What is Dart MCP Server about?

Provides a local Model Context Protocol (MCP) server that exposes task and document management capabilities for Dart, allowing AI assistants to perform common project‑management actions without directly handling the underlying API.

How to use Dart MCP Server?

1. Obtain your Dart authentication token from your Dart profile.
2. Add the following MCP server definition to the client’s MCP configuration (e.g., claude_mcp_config.json, cursor_mcp_config.json):

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

3. Restart the client or reload its MCP settings. The client will now communicate with the server via the defined prompts and tools.

Key features of Dart MCP Server

• Prompts: create-task, create-doc, summarize-tasks for quick AI‑driven actions.
• Resource templates: Access configuration, tasks, and docs via URIs such as dart-config:, dart-task:///{taskId}, dart-doc:///{docId}.
• Task management tools: get_config, list_tasks, create_task, get_task, update_task, delete_task, add_task_comment.
• Document management tools: list_docs, create_doc, get_doc, update_doc, delete_doc.
• Structured JSON responses and comprehensive input validation.

Use cases of Dart MCP Server

• AI‑assisted task creation: An AI assistant can generate new tasks with proper fields (title, assignee, priority) using the create-task prompt.
• Automated summarization: Summarize current tasks filtered by status or assignee via summarize-tasks.
• Document handling: Create or retrieve project documentation on‑the‑fly with create-doc and get_doc.
• Integration with IDE assistants: Tools like Claude Desktop, Cursor, or Cline can invoke the server to keep project boards up‑to‑date without manual API calls.

FAQ

• Is the local server still recommended? No. The local server is deprecated; Dart now recommends using the hosted MCP server with its simplified configuration.
• Can I run the server with Docker instead of npx? Yes. Build the image using docker build -t mcp/dart . and run it with the provided Docker command in the README.
• Where do I find my Dart token? Log into Dart, go to Settings → Account, and copy the token labeled DART_TOKEN.
• What environment variable is required? DART_TOKEN must be provided so the server can authenticate API requests.
• How do I add custom prompts or tools? Extend the server’s source code and publish a new npm version; the MCP client will automatically pick up new definitions.

Dart is Project Management powered by AI.

[!WARNING] The Dart local MCP server is deprecated in favor of the simplified and improved hosted Dart MCP server, which you can configure with these instructions.

• Features
  • Prompts
  • Resource templates
  • Tools
    • Task management
    • Document management
• Setup
  • Find the MCP settings file for the client
    • Claude Desktop
    • Claude Code
    • Cursor
    • Cline
    • Windsurf
    • Any other client
  • Set up the MCP server
  • Variant: setup with Docker
• Help and Resources
• Contributing
• License

Features

Prompts

The following prompts are available

• create-task - Create a new task in Dart with title, description, status, priority, and assignee
• create-doc - Create a new document in Dart with title, text content, and folder
• summarize-tasks - Get a summary of tasks with optional filtering by status and assignee

These prompts make it easy for AI assistants to perform common actions in Dart without needing to understand the underlying API details.

Resource templates

The following resources are available

• dart-config: - Configuration information about the user's space
• dart-task:///{taskId} - Detailed information about specific tasks
• dart-doc:///{docId} - Detailed information about specific docs

Tools

The following tools are available

Task management

• get_config - Get information about the user's space, including available assignees, dartboards, folders, statuses, tags, priorities, and sizes
• list_tasks - List tasks with optional filtering by assignee, status, dartboard, priority, due date, and more
• create_task - Create a new task with title, description, status, priority, size, dates, dartboard, assignees, tags, and parent task
• get_task - Retrieve an existing task by its ID
• update_task - Update an existing task's properties
• delete_task - Move a task to the trash (recoverable)
• add_task_comment - Add a comment to an existing task

Document management

• list_docs - List docs with optional filtering by folder, title, text content, and more
• create_doc - Create a new doc with title, text content, and folder
• get_doc - Retrieve an existing doc by its ID
• update_doc - Update an existing doc's properties
• delete_doc - Move a doc to the trash (recoverable)

Each tool supports comprehensive input validation and returns structured JSON responses.

Setup

The easiest way to run the MCP server is with npx, but a Docker setup is also available.

Find the MCP settings file for the client

Claude Desktop

1. Install Claude Desktop as needed
2. Open the config file by opening the Claude Desktop app, going into its Settings, opening the 'Developer' tab, and clicking the 'Edit Config' button
3. Follow the 'Set up the MCP server' steps below

Claude Code

1. Install Claude Code as needed

2. Copy your authentication token from your Dart profile

3. Run the following command, being sure to replace dsa... with your actual Dart token

   claude mcp add dart -e DART_TOKEN=dsa_... -- npx -y dart-mcp-server@latest
   

Cursor

1. Install Cursor as needed
2. Open the config file by opening Cursor, going into 'Cursor Settings' (not the normal VSCode IDE settings), opening the 'MCP' tab, and clicking the 'Add new global MCP server' button
3. Follow the 'Set up the MCP server' steps below

Cline

1. Install Cline in your IDE as needed
2. Open the config file by opening your IDE, opening the Cline sidebar, clicking the 'MCP Servers' icon button that is second from left at the top, opening the 'Installed' tab, and clicking the 'Configure MCP Servers' button
3. Follow the 'Set up the MCP server' steps below

Windsurf

1. Install Windsurf as needed
2. Open the config file by opening Windsurf, going into 'Windsurf Settings' (not the normal VSCode IDE settings), opening the 'Cascade' tab, and clicking the 'View raw config' button in the 'Model Context Protocol (MCP) Servers' section
3. Follow the 'Set up the MCP server' steps below

Any other client

1. Find the MCP settings file, usually something like [client]_mcp_config.json
2. Follow the 'Set up the MCP server' steps below

Set up the MCP server

1. Install npx, which comes bundled with Node, as needed

2. Copy your authentication token from your Dart profile

3. Add the following to your MCP setup, being sure to replace dsa... with your actual Dart token

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

Variant: setup with Docker

If the npx setup above does not work well, we also provide a Docker setup. Follow the instructions above to find the MCP settings file

1. Install Docker as needed

2. Build the Docker container with docker build -t mcp/dart .

3. Copy your authentication token from your Dart profile

4. Add the following to your MCP setup, being sure to replace dsa... with your actual Dart token

   {
     "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_..."
         }
       }
     }
   }
   

Help and Resources

• Homepage
• Web App
• Help Center
• Bugs and Features
• Library Source
• Chat on Discord
• Email us at support@dartai.com

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

License

This project is licensed under the MIT License.