A Model Context Protocol (MCP) server implementation for Dart, providing task management, document handling, and workspace organization capabilities through MCP tools.
Prerequisites
- Node.js 16.x or higher
- Python 3.8 or higher
- Dart Python SDK installed (
pip install dart-sdk)
- A valid Dart API token
Features
- Task Management
- Create and update tasks
- Set task priorities and status
- Assign tasks to team members
- Document Management
- Create and organize documents
- Support for markdown content
- Report generation
- Space Management
- Create and manage workspaces
- Organize content with folders
- Control access permissions
- Dartboard Integration
- Default status management
- Task organization
- Team collaboration
Installation
Installing via Smithery
To install Dart MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @jmanhype/dart-mcp-server --client claude
Manual Installation
-
Clone the repository:
git clone https://github.com/jmanhype/dart-mcp-server.git
cd dart-mcp-server
-
Install Node.js dependencies:
npm install
-
Set up Python environment and install Dart SDK:
# Create and activate virtual environment
python -m venv .venv
source .venv/bin/activate # On Windows: .venvScriptsactivate
# Install Dart SDK
pip install dart-sdk
-
Set up environment variables:
# Copy example environment file
cp .env.example .env
# Edit .env with your configuration
# Required: DART_TOKEN
# Optional: PYTHONPATH (path to dart sdk)
Usage
-
Build the TypeScript code:
npm run build
-
Start the MCP server:
npm start
Development
# Watch for TypeScript changes
npm run dev
# Run tests
npm test
Environment Variables
Create a .env file with the following variables:
# Required: Your Dart API token
DART_TOKEN=your_dart_token_here
# Optional: Path to your Dart SDK installation
PYTHONPATH=/path/to/dart/sdk
# Optional: Python executable path (defaults to system Python)
PYTHON_PATH=/path/to/python
create_task: Create new tasks with title, description, priority, etc.update_task: Update existing tasks' status, title, descriptionget_default_status: Get default status DUIDsget_default_space: Get default space DUIDget_dartboards: List available dartboardsget_folders: List folders in a spacecreate_folder: Create new folderscreate_doc: Create new documents or reportscreate_space: Create new workspacesdelete_space: Delete existing workspaces
Troubleshooting
If you encounter issues:
-
Verify Python environment:
python --version
pip list | grep dart
-
Check Dart SDK installation:
python -c "import dart; print(dart.__version__)"
-
Verify environment variables:
echo $DART_TOKEN
echo $PYTHONPATH
License
MIT License
PyPI Supported Python Versions License
Dart is Project Management powered by AI.
dart-tools is the Dart CLI and Python Library. It enables direct integration with Dart through a terminal CLI or through Python.
- Installation
- Using the CLI
- Using the Python Library
- Using the Python Library in AWS Lambda Functions
- Using the MCP Server
- Advanced Usage
- Help and Resources
- Contributing
- License
Installation
In the terminal, install by running
pip install dart-tools
Using the CLI
Start off by setting up authentication with
dart login
Then, you can create a new task with a command along the lines of
dart createtask "Update the landing page" -p0 --tag marketing
which will make a new task called 'Update the landing page' with priority 'Critical' (i.e. P0) and with the 'marketing' tag.
You can explore all of these options and many more with dart --help or the more specific help for subcommands, in this case dart createtask --help.
Another common workflow is to updating a preexisting task. To do this, run something like
dart updatetask [DUID] -s Done
This command will mark the referenced task 'Done'. Here [DUID] is meant to be replaced (including the brackets) with the 'Dart ID' of an existing task. You can get a DUID from any existing task in a number of ways, such as by copying it from the end of a task's URL or by clicking the '...' button in a task page in Dart and then choosing 'Copy ID'.
Using the Python Library
First, set up authentication. Run dart login in the terminal for an interactive process, or visit your Dart profile and then run dart.login(token) or save the token into the DART_TOKEN environment variable.
Then, you can run something like
import os
from dart import create_task, is_logged_in, update_task
# Check that auth is set up and stop if not, can remove this once everything is set up
is_logged_in(should_raise=true)
# Create a new task called 'Update the landing page' with priority 'Critical' (i.e. p0) and with the 'marketing' tag
new_task = create_task(
"Update the landing page", priority_int=0, tag_titles=["marketing"]
)
# Update the task to be 'Done'
update_task(new_task.duid, status_title="Done")
Using the MCP Server
The Model Context Protocol (MCP) server implementation enables AI assistants (like Claude) to interact with Dart through standardized tools. This allows for seamless integration of AI capabilities with Dart's task management system.
Installation
# Clone the repository
git clone https://github.com/its-dart/dart-tools.git
cd dart-tools/dart/mcp
# Install dependencies
npm install
# Set up Python environment
python -m venv .venv
source .venv/bin/activate # On Windows: .venvScriptsactivate
pip install dart-tools
# Configure environment
cp .env.example .env
# Edit .env with your DART_TOKEN
The server provides these MCP tools:
- Task Management (create/update tasks)
- Document Management (create/organize docs)
- Space Management (workspaces/folders)
- Dartboard Integration
For detailed documentation, see MCP Server README.
Advanced Usage
Almost anything that can be done in Dart can be done with the Python library, but there are not convenient wrapper functions for everything. For most advanced usage, the best thing to do is to get in touch with us and we can help.
However, if you want to explore on your own, the client is well-typed, so you can simply explore the code to see what is possible. All updates will go through the the dart.transact function.
As an example, you could run something akin to update_task with
from dart import (
Dart,
Operation,
OperationKind,
OperationModelKind,
TaskUpdate,
TransactionKind,
)
# Initialize the inner client
dart = Dart()
# Prepare the update operation
task_update = TaskUpdate(
duid="[DUID]",
size=5,
)
task_update_op = Operation(
model=OperationModelKind.TASK,
kind=OperationKind.UPDATE,
data=task_update,
)
# Call the operation transactionally to perform the update
response = dart.transact([task_update_op], TransactionKind.TASK_UPDATE)
Help and Resources
- Homepage
- Web App
- Help Center
- Bugs and Features
- Library Source
- Chat on Discord
- Email us at [email protected]
Contributing
Contributions are welcome! Please open an issue or submit a pull request.
License
This project is licensed under the MIT License.
[
{
"description": "Get the default status DUIDs",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "get_default_status"
},
{
"description": "Get the default space DUID",
"inputSchema": {
"properties": {},
"required": [],
"type": "object"
},
"name": "get_default_space"
},
{
"description": "Create a new Dart task",
"inputSchema": {
"properties": {
"assignee_duids": {
"description": "List of assignee DUIDs",
"items": {
"type": "string"
},
"type": "array"
},
"description": {
"description": "Description of the task",
"type": "string"
},
"priority": {
"description": "Priority of the task",
"enum": [
"Low",
"Medium",
"High",
"Critical"
],
"type": "string"
},
"size": {
"description": "Size/complexity of the task (1-5)",
"maximum": 5,
"minimum": 1,
"type": "number"
},
"subscriber_duids": {
"description": "List of subscriber DUIDs",
"items": {
"type": "string"
},
"type": "array"
},
"tags": {
"description": "Tags for the task",
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"description": "Title of the task",
"type": "string"
}
},
"required": [
"title",
"description"
],
"type": "object"
},
"name": "create_task"
},
{
"description": "Update an existing task",
"inputSchema": {
"properties": {
"description": {
"description": "New description for the task",
"type": "string"
},
"duid": {
"description": "DUID of the task to update",
"type": "string"
},
"priority": {
"description": "New priority for the task",
"enum": [
"Low",
"Medium",
"High",
"Critical"
],
"type": "string"
},
"status_duid": {
"description": "New status DUID",
"type": "string"
},
"title": {
"description": "New title for the task",
"type": "string"
}
},
"required": [
"duid"
],
"type": "object"
},
"name": "update_task"
},
{
"description": "Get available dartboards",
"inputSchema": {
"properties": {
"space_duid": {
"description": "Space DUID to get dartboards from",
"type": "string"
}
},
"required": [
"space_duid"
],
"type": "object"
},
"name": "get_dartboards"
},
{
"description": "Get available folders",
"inputSchema": {
"properties": {
"space_duid": {
"description": "Space DUID to get folders from",
"type": "string"
}
},
"required": [
"space_duid"
],
"type": "object"
},
"name": "get_folders"
},
{
"description": "Create a new folder in a space",
"inputSchema": {
"properties": {
"description": {
"description": "Description of the folder",
"type": "string"
},
"kind": {
"default": "Default",
"description": "Kind of folder",
"enum": [
"Default",
"Reports",
"Other"
],
"type": "string"
},
"space_duid": {
"description": "Space DUID to create the folder in",
"type": "string"
},
"title": {
"description": "Title of the folder",
"type": "string"
}
},
"required": [
"space_duid",
"title"
],
"type": "object"
},
"name": "create_folder"
},
{
"description": "Create a new document or report",
"inputSchema": {
"properties": {
"editor_duids": {
"description": "List of editor DUIDs",
"items": {
"type": "string"
},
"type": "array"
},
"folder_duid": {
"description": "Folder DUID to create the document in",
"type": "string"
},
"report_kind": {
"description": "Kind of report (if creating a report)",
"enum": [
"Changelog",
"Standup"
],
"type": "string"
},
"subscriber_duids": {
"description": "List of subscriber DUIDs",
"items": {
"type": "string"
},
"type": "array"
},
"text": {
"description": "Content of the document",
"type": "string"
},
"text_markdown": {
"description": "Markdown content of the document",
"type": "string"
},
"title": {
"description": "Title of the document",
"type": "string"
}
},
"required": [
"folder_duid",
"title"
],
"type": "object"
},
"name": "create_doc"
},
{
"description": "Create a new space",
"inputSchema": {
"properties": {
"abrev": {
"description": "Short abbreviation for the space",
"type": "string"
},
"accessible_by_team": {
"default": true,
"description": "Whether the space is accessible by the whole team",
"type": "boolean"
},
"accessible_by_user_duids": {
"description": "List of user DUIDs who can access the space",
"items": {
"type": "string"
},
"type": "array"
},
"color_hex": {
"description": "Color in hex format (e.g. #FF0000)",
"type": "string"
},
"description": {
"description": "Description of the space",
"type": "string"
},
"icon_kind": {
"default": "None",
"description": "Kind of icon to use",
"enum": [
"None",
"Icon",
"Emoji"
],
"type": "string"
},
"icon_name_or_emoji": {
"description": "Icon name or emoji character",
"type": "string"
},
"sprint_mode": {
"default": "None",
"description": "Sprint mode for the space",
"enum": [
"None",
"ANBA"
],
"type": "string"
},
"sprint_name_fmt": {
"description": "Sprint name format",
"type": "string"
},
"sprint_replicate_on_rollover": {
"default": false,
"description": "Whether to replicate sprints on rollover",
"type": "boolean"
},
"title": {
"description": "Title of the space",
"type": "string"
}
},
"required": [
"title"
],
"type": "object"
},
"name": "create_space"
},
{
"description": "Delete a space and all its contents",
"inputSchema": {
"properties": {
"space_duid": {
"description": "DUID of the space to delete",
"type": "string"
}
},
"required": [
"space_duid"
],
"type": "object"
},
"name": "delete_space"
}
]