Dart MCP Server

What is Dart MCP Server?

Dart MCP Server bridges the Dart project management platform to AI assistants by exposing task, document, space, and dartboard operations as MCP tools. It is written in TypeScript but delegates all Dart API calls to a Python subprocess using the dart-sdk package.

How to use Dart MCP Server?

Install via Smithery (npx -y @smithery/cli install @jmanhype/dart-mcp-server --client claude) or manually by cloning the repository, running npm install (which also sets up the Python virtualenv and installs dart-sdk), then npm run build and npm start. Set the DART_TOKEN environment variable with your Dart API token.

Key features of Dart MCP Server

• Exposes nine MCP tools for Dart platform operations
• Creates, updates, and lists tasks, documents, and spaces
• Communicates over stdio using the MCP protocol
• Spawns a Python subprocess for each API call
• Returns JSON results to the MCP client
• Supports custom Python path via PYTHON_PATH environment variable

Use cases of Dart MCP Server

• Create tasks with title, description, priority, and assignees via AI assistants
• Update task status or details by DUID from natural language prompts
• List available dartboards, spaces, and folders for project overview
• Create and delete workspaces programmatically
• Generate documents or reports in a Dart space

FAQ from Dart MCP Server

What MCP transport does Dart MCP Server use?

Dart MCP Server uses the stdio transport.

What are the runtime dependencies for Dart MCP Server?

Node.js >= 16.0.0, Python >= 3.8.0, the dart-sdk Python package, and the @modelcontextprotocol/sdk npm package.

How does Dart MCP Server execute Dart API calls?

Each MCP tool handler builds a Python script as a string, spawns python3 -c "<script>", and parses the JSON output from stdout. A new Python process is spawned for every tool call.

What are the known limitations of Dart MCP Server?

Every tool call spawns a new Python process, the .env path is hardcoded to /Users/speed/dart-tools/.env, there is no input validation beyond the Dart SDK, no pagination for list operations, and error messages from the Python subprocess are passed through as-is.

How do I authenticate with Dart MCP Server?

Set the DART_TOKEN environment variable with your Dart API token (obtained from your Dart profile). Optionally, set PYTHONPATH or PYTHON_PATH if the Dart SDK is not in the default location.