Dart MCP Server

🚀 Dart MCP Server

Dart is a task management tool integrated with AI assistants (such as Claude) through the MCP (Model Context Protocol) server. This server allows AI to call Dart's functions, including creating and updating tasks, organizing documents, and managing workspaces and folders.

🚀 Quick Start

Dart is a task - management tool that integrates with AI assistants like Claude via the MCP (Model Context Protocol) server. The server enables AI to utilize Dart's features for task creation, document organization, and workspace management.

✨ Features

• Task Management: Create, update, and query tasks.
• Document Management: Create and organize documents.
• Workspace and Folder Management: Manage workspaces and folders in Dartboard.
• Dartboard Integration: Seamlessly integrate with other Dart features.

📦 Installation

Prerequisites

1. Install Node.js and npm
   Ensure that Node.js and npm are installed on your system. You can visit the Node.js official website to download and install the latest version.
2. Install Python and pip
   Make sure Python 3 and pip are installed on your system. You can check and install them using the following commands:

   python --version
   pip install --upgrade pip
   

3. Install Dart Tools
   Clone the Dart repository and follow the Dart Installation Guide for installation.

Installation Methods

Installation via Smithery

# Clone the repository
git clone https://github.com/its-dart/dart-tools.git
cd dart-tools/dart/mcp

# Install dependencies
npm install

# Initialize the Python environment
python -m venv .venv
source .venv/bin/activate  # Use .venv\Scripts\activate on Windows
pip install dart-tools

# Configure environment variables
cp .env.example .env
# Edit the .env file and set your DART_TOKEN

Manual Installation

# Clone the repository
git clone https://github.com/its-dart/dart-tools.git
cd dart-tools/dart/mcp

# Install dependencies
npm install

# Initialize the Python environment
python -m venv .venv
source .venv/bin/activate  # Use .venv\Scripts\activate on Windows
pip install dart-tools

# Configure environment variables
cp .env.example .env
# Edit the .env file and set your DART_TOKEN

💻 Usage Examples

Basic Usage

Create a Task

dart createtask "Update the login page" -p0 --tag Marketing

Update a Task

dart updatetask [DUID] -s Completed

Advanced Usage

Python Library Usage Example

import os
from dart import create_task, is_logged_in, update_task

is_logged_in(should_raise=True)

new_task = create_task(
    "Update the login page", 
    priority_int=0, 
    tag_titles=["Marketing"]
)

update_task(new_task.duid, status_title="Completed")

📚 Documentation

Development Steps

1. Clone the repository:

   git clone https://github.com/its-dart/dart-tools.git
   cd dart-tools/dart/mcp
   

2. Install dependencies:

   npm install
   

3. Initialize the Python environment and install packages:

   python -m venv .venv
   source .venv/bin/activate  # Use .venv\Scripts\activate on Windows
   pip install dart-tools
   

4. Configure environment variables:

   cp .env.example .env
   # Edit the .env file and set your DART_TOKEN
   

Available MCP Tools

• Create a Task: dart createtask
• Update a Task: dart updatetask
• Query Tasks: dart listtasks

Help and Support

If you need help, please visit the Dart official documentation or contact the support team.