📌 Overview

Purpose: The Dart MCP Server provides an official AI Model Context Protocol (MCP) server for facilitating project management through AI-driven interactions.

Overview: The dart-mcp-server serves as a backend solution for managing tasks and documents within the Dart ecosystem. By utilizing the capabilities of AI, it simplifies the interaction between users and the underlying project management system, enabling seamless task and document management.

Key Features:

Prompts: Provides specific commands like create-task, create-doc, and summarize-tasks, enabling AI assistants to perform actions without in-depth API knowledge.
Resource Templates: Offers structured resources such as dart-config: for configuration data and detailed links to specific tasks and documents, enhancing the ability to access and manage project-related information.
Tools: Includes task management and document management features that allow users to create, retrieve, update, and delete tasks and documents, while supporting comprehensive input validation and structured JSON responses for easy integration with various clients.

Dart MCP Server

Dart is Project Management powered by AI.

dart-mcp-server is the official AI Model Context Protocol (MCP) server for Dart.

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 documents.

Tools

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).

Document management

list_docs - List documents with optional filtering by folder, title, text content, and more.
create_doc - Create a new document with title, text content, and folder.
get_doc - Retrieve an existing document by its ID.
update_doc - Update an existing document's properties.
delete_doc - Move a document 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

Install Claude Desktop as needed from https://claude.ai/download.
Open the claude_desktop_config.json file by opening the Claude Desktop app, navigating to Settings, opening the 'Developer' tab, and clicking the 'Edit Config' button.
Follow the 'Set up the MCP server' steps below.

Cline

Install Cline in your IDE as needed from https://cline.bot/.
Install the MCP server by opening your IDE, opening the Cline sidebar, clicking the 'MCP Servers' icon button, opening the 'Installed' tab, and clicking the 'Configure MCP Servers' button.
Follow the 'Set up the MCP server' steps below.

Any other client

Find the MCP settings file, usually named [client]_mcp_settings.json.
Follow the 'Set up the MCP server' steps below.

Set up the MCP server

Install npx (comes bundled with Node) as needed from https://nodejs.org/en/download.
Copy your authentication token from your Dart profile at https://app.itsdart.com/?settings=account.

Add the following to your MCP setup, replacing dsa... with your actual Dart token:

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

Variant: Setup with Docker

If the npx setup does not work well, a Docker setup is also available. Follow the instructions above to locate the MCP settings file.

Install Docker as needed from https://www.docker.com/products/docker-desktop/.
Build the Docker container with:
```
docker build -t mcp/dart .
```
Copy your authentication token from your Dart profile at https://app.itsdart.com/?settings=account.

Add the following to your MCP setup, replacing dsa... with your actual Dart token:

{
  "mcpServers": {
    "dart": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "DART_TOKEN", "mcp/dart"],
      "env": {
        "DART_TOKEN": "dsa_..."
      }
    }
  }
}

Help and Resources

Homepage: https://www.itsdart.com/?nr=1
Web App: https://app.itsdart.com/
Help Center: https://help.itsdart.com/
Bugs and Features: https://app.itsdart.com/p/r/JFyPnhL9En61
Library Source: https://github.com/its-dart/dart-mcp-server/
Chat on Discord: https://discord.gg/RExv8jEkSh
Email: support@itsdart.com

Contributing

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

License

This project is licensed under the MIT License.