Skip to main content
Glama

dart-query

MCP server for Dart AI task management, optimized for batch operations and minimal context usage.

Instead of looping through tasks one-by-one (filling your context window with intermediate JSON), dart-query uses DartQL selectors and server-side batch operations to update hundreds of tasks in a single call. A 50-task update that would normally consume ~30K tokens takes ~200 tokens with zero context rot.

Quick Start

1. Get Your Dart AI Token

Visit https://app.dartai.com/?settings=account and copy your token (starts with dsa_).

2. Configure MCP

npx (recommended)

{
  "mcpServers": {
    "dart-query": {
      "command": "npx",
      "args": ["-y", "@standardbeagle/dart-query"],
      "env": {
        "DART_TOKEN": "dsa_your_token_here"
      }
    }
  }
}

SLOP-MCP (v0.10.0+)

slop register dart-query \
  --command npx \
  --args "-y" "@standardbeagle/dart-query" \
  --env DART_TOKEN=dsa_your_token_here \
  --scope user

3. Verify

info({ level: "overview" })

4. Example: Batch Update

// Preview first
batch_update_tasks({
  selector: "dartboard = 'Engineering' AND priority = 'high'",
  updates: { status: "Doing" },
  dry_run: true
})

// Execute
batch_update_tasks({
  selector: "dartboard = 'Engineering' AND priority = 'high'",
  updates: { status: "Doing" },
  dry_run: false
})

Related MCP server: MCP Tasks

Tools

Group

Tools

Purpose

Discovery

info, get_config

Explore capabilities, workspace config

Task CRUD

create_task, get_task, update_task, delete_task, add_task_comment

Single task operations

Query

list_tasks, search_tasks

Find tasks with filters or full-text search

Batch

batch_update_tasks, batch_delete_tasks, get_batch_status

Bulk operations with DartQL selectors

Import

import_tasks_csv

Bulk create from CSV with validation

Docs

list_docs, create_doc, get_doc, update_doc, delete_doc

Document management

See TOOLS.md for full parameter references, DartQL syntax, and CSV import format.

DartQL Selectors

SQL-92 WHERE clause syntax for targeting tasks in batch operations:

dartboard = 'Engineering' AND priority = 'high' AND tags CONTAINS 'bug'
due_at < '2026-01-18' AND status <> 'Done'
title LIKE 'Task%'                          -- starts with
title LIKE '%auth%'                         -- contains substring

Operators: =, !=, <>, >, >=, <, <=, LIKE, IN, NOT IN, BETWEEN, IS NULL, IS NOT NULL, CONTAINS Aliases: INCLUDES/HAS → CONTAINS · <> → != LIKE wildcards: % = any characters, _ = single character (case-insensitive)

Safety

All Dart AI operations are production (no sandbox). dart-query provides:

  • Dry-run mode on all batch operations — preview before executing

  • Validation phase for CSV imports — catch errors before creating anything

  • Confirmation flag (confirm: true) required for batch deletes

  • Recoverable deletes — tasks move to trash, not permanent deletion

License

MIT

Available Tools

25 tools
add_task_commentA

Add a comment to a task for status updates, AI rationale, or notes. Supports markdown formatting.

Inputs: dart_id (required), text (required).

add_time_trackingB

Add a time tracking entry to a task. Supports started_at/finished_at or duration_minutes.

Inputs: dart_id (required), started_at (required), finished_at, duration_minutes, +1 more.

attach_urlA

Attach a file from URL to a task. URL must be publicly accessible.

Inputs: dart_id (required), url (required), filename.

batch_delete_tasksA

[Deprecated: use execute_dartql] Batch delete multiple tasks matching a DartQL selector. MOST DANGEROUS OPERATION! CRITICAL: dry_run defaults to true, confirm=true REQUIRED when dry_run=false. Tasks move to trash (recoverable).

Inputs: selector (required), dry_run, confirm, concurrency.

batch_update_tasksA

[Deprecated: use execute_dartql] Batch update multiple tasks matching a DartQL selector. Supports all task fields including relationships. CRITICAL: Always use dry_run=true first to preview changes!

Inputs: selector (required), updates (required), dry_run, concurrency.

create_docB

Create a new document with title, text (markdown supported), and optional folder

Inputs: title (required), text (required), folder.

create_taskA

Create a new task with title, description, status, priority, size, dates, dartboard, assignees, tags, and task relationships (subtasks, blockers, related tasks)

Inputs: title (required), dartboard (required), description, status, +13 more.

delete_docA

Delete a document (moves to trash - recoverable via Dart web UI)

Inputs: doc_id (required).

delete_taskA

Delete a task (moves to trash - recoverable via Dart web UI)

Inputs: dart_id (required).

execute_dartqlA

Execute DartQL UPDATE/DELETE statements. Supports template vars {field}, array literals, comments, and multi-statement (;). Dry-run by default.

Inputs: query (required), dry_run, concurrency.

get_batch_statusA

Retrieve status of a batch operation (update, delete, import, or dartql) by batch_operation_id. Operations are kept in memory for 1 hour.

Inputs: batch_operation_id (required).

get_configA

Get workspace configuration: assignees, dartboards, statuses, tags, priorities, sizes

Inputs: cache_bust, include.

get_dartboardB

Get details about a dartboard including task count. Token-efficient lookup.

Inputs: dartboard_id (required).

get_docA

Get a specific document by doc_id with full text content

Inputs: doc_id (required).

get_folderA

Get details about a folder including doc count. Token-efficient lookup.

Inputs: folder_id (required).

get_taskA

Get a specific task by dart_id with optional comments and relationship details. Returns task relationships (subtasks, blockers, blocking, duplicates, related) with counts and optional expanded titles.

Inputs: dart_id (required), include_comments, include_relationships, expand_relationships.

import_tasks_csvA

Import tasks from CSV file with validation and parallel creation. CRITICAL: ALWAYS use validate_only=true first! Production safety: validate → fix errors → import.

Inputs: dartboard (required), csv_data, csv_file_path, column_mapping, +3 more.

infoB

Progressive discovery of dart-query capabilities - start here

Inputs: level, target.

list_commentsA

List comments on a task with pagination. Token-efficient: returns minimal comment data.

Inputs: task_id (required), limit, offset.

list_docsA

List documents with optional filtering by folder, title_contains, text_contains. Supports pagination.

Inputs: folder, title_contains, text_contains, limit, +1 more.

list_tasksB

Query tasks with filters (assignee, status, dartboard, priority, tags, dates, has_parent), pagination, and detail levels. Parent filter uses client-side filtering.

Inputs: assignee, status, dartboard, priority, +7 more.

move_taskA

Move/reposition a task within a dartboard or to a different dartboard. Supports ordering by index or relative to another task.

Inputs: dart_id (required), dartboard, order, after_id, +1 more.

search_tasksA

Full-text search across tasks with relevance ranking. Alternative to list_tasks for text-based discovery. Supports quoted phrases, exclusions (-term), and inline filters (dartboard:Name, status:Done, assignee:Name).

Inputs: query (required), dartboard, include_completed, limit.

update_docA

Update an existing document (title, text, or folder). Validates references and only sends changed fields.

Inputs: doc_id (required), updates (required).

update_taskA

Update a task. Pass dart_id and any fields to change at the top level. Supports add_to/remove_from for incremental relationship changes and optional comment. Relationship arrays use full replacement unless using add_to/remove_from.

Inputs: dart_id (required), title, description, dartboard, +16 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 25 tools

    Disambiguation3/5

    Most tools target distinct resources (tasks, docs, folders, config), but there is overlap between list_tasks and search_tasks (both find tasks, though one is filter-based and the other text-based). Also, batch_delete_tasks and batch_update_tasks are deprecated alternatives to execute_dartql, creating potential confusion about which to use. The descriptions do help clarify, but the presence of deprecated tools adds ambiguity.

    Naming Consistency4/5

    Tool names follow a mostly consistent verb_noun pattern (get_task, update_task, create_task, delete_task, list_docs, etc.). Some deviations exist like 'execute_dartql' (non-noun object) and 'import_tasks_csv' (instead of import_tasks_csv_file or similar), but these are minor and the pattern is still readable.

    Tool Count3/5

    With 25 tools, this is on the heavier side for a task management server. Many tools are focused on task lifecycle (create, get, update, delete, move, comment, time tracking), but some like batch operations and import seem redundant with execute_dartql. A few tools could be merged (e.g., batch_update and batch_delete into execute_dartql), but the count is not excessive given the domain complexity.

    Completeness3/5

    The server covers core CRUD for tasks (create, read, update, delete) and documents (create, read, update, delete), plus additional features like comments, time tracking, and URL attachments. However, there is no direct way to list or delete comments, and while tasks support relationships, there is no explicit tool to manage dartboard or folder creation/deletion (only get). The presence of deprecated tools suggests some operations are being consolidated, but the surface is fairly complete for task management with some gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers