vikunja-fastmcp MCP server

Check connection and get currently authenticated user details or connection status. Actions: status; self-check.

Run a compact configuration and connection self-check; use detail=full only for diagnostics.

List visible projects or retrieve a specific project details. Actions: list; get requires project.id or project.title.

Get current user profile or search other users. Actions: current; search.

Create, update, delete, close, assign, label, relate, or attach files to tasks. Actions: create requires projectSelector, fields.title; create_if_absent requires projectSelector, fields.title; upsert requires projectSelector, fields.title, externalKey; get requires taskSelector; list; summary requires projectSelector; update requires taskSelector, fields; delete requires taskSelector; close requires taskSelector; reopen requires taskSelector; close_with_evidence requires taskSelector, evidenceComment; assign requires taskSelector, userSelector; unassign requires taskSelector, userSelector; list-assignees requires taskSelector; apply-label requires taskSelector, labelTitle; remove-label requires taskSelector, labelTitle; list-labels requires taskSelector; set_status requires taskSelector, statusLabel; relate requires taskSelector, otherTaskSelector, relationKind; unrelate requires taskSelector, otherTaskSelector, relationKind; list-relations requires taskSelector; attach requires taskSelector, filePaths or base64Content+filename; list-attachments requires taskSelector; download-attachment requires taskSelector, attachmentId.

Manage task comments (create, list, get, update, delete). Actions: create requires taskSelector, comment; list requires taskSelector; get requires taskSelector, commentId; update requires taskSelector, commentId, comment; delete requires taskSelector, commentId.

List, get, create, update, or delete global labels. Actions: list; get requires labelSelector; create requires title; update requires labelSelector; delete requires labelSelector.

Preferred way to create or upsert several tasks in one call. Also supports bounded update, delete, assign, and unassign batches. Actions: update requires taskIds, fields; create requires projectSelector, tasks; delete requires taskIds, confirm; assign requires taskIds, userSelector; unassign requires taskIds, userSelector.

Request a native Vikunja user-data export. Password input is never returned. Actions: request.

Manage teams and team members. Actions: list; get requires teamId; create requires name; update requires teamId, name; delete requires teamId; add-member requires teamId, usernameOrId (username only for add); remove-member requires teamId, usernameOrId; set-member-admin requires teamId, usernameOrId, admin.

Create, read, update, or delete saved filters. Listing is unsupported (no collection route in the Vikunja v2 API); see self_check.unsupportedOperations. Actions: create requires title, filterQuery; get requires filterId; update requires filterId; delete requires filterId.

List, add, or remove reminders stored on a task. Actions: list requires taskSelector; add requires taskSelector; remove requires taskSelector, reminderIndex.

Check user-export status or download the ready archive to sandboxed local disk. Actions: status; download.

Detect, preview, import, or inspect CSV data through native-fast or MCP-idempotent mode. Actions: detect requires filePath; preview requires filePath, config; import requires filePath, config; status.

Export one project task list to a local JSON or CSV file. Actions: export requires projectSelector.

List webhook events or manage project-scoped and user-scoped webhooks. Actions: events; list; create requires targetUrl, events; update requires webhookId, events; delete requires webhookId.

Manage machine-local task templates or instantiate one in an explicit project. Actions: list; create requires name, fields; get requires templateSelector; delete requires templateSelector; instantiate requires templateSelector, projectSelector.