Vikunja MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| VIKUNJA_URL | Yes | Vikunja instance URL (required) | |
| VIKUNJA_API_TOKEN | Yes | Authentication token (required) |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| vikunja_authC | Manage authentication with Vikunja API (connect, status, refresh, disconnect) |
| vikunja_tasksD | Manage tasks with comprehensive operations (create, update, delete, list, assign, attach files, comment, bulk operations) |
| vikunja_task_crudC | Manage individual tasks: create, get, update, delete, list |
| vikunja_task_bulkC | Manage bulk task operations: create, update, delete multiple tasks |
| vikunja_task_assigneesC | Manage task assignments: assign users, unassign users, list assignees |
| vikunja_task_commentsC | Manage task comments: add comments to tasks |
| vikunja_task_remindersC | Manage task reminders: add, remove, list reminders |
| vikunja_task_labelsC | Manage task labels: apply, remove, list labels |
| vikunja_task_relationsC | Manage task relationships: relate tasks, unrelate tasks, list relations |
| vikunja_projectsC | Manage projects with full CRUD operations, hierarchy management, and sharing capabilities |
| vikunja_labelsC | Manage task labels with full CRUD operations for organizing and categorizing tasks |
| vikunja_teamsC | Manage teams and team memberships for collaborative project management |
| vikunja_filtersC | Manage and build advanced filters for tasks and projects with validation |
| vikunja_templatesD | Manage task templates for creating consistent tasks and project structures |
| vikunja_webhooksC | Manage webhooks for integrating Vikunja events with external services |
| vikunja_batch_importB | Import tasks in bulk from CSV or JSON formats with error handling and dry-run support |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 16 tools
The vikunja_tasks tool overlaps significantly with multiple specialized tools (e.g., vikunja_task_crud, vikunja_task_assignees, vikunja_task_comments, vikunja_task_bulk), creating ambiguity about which tool to use for common operations. Additionally, vikunja_labels and vikunja_task_labels are distinct but their names are confusingly similar.
All tools share a consistent 'vikunja_' prefix and use snake_case. Most tools follow a verb_noun pattern (e.g., vikunja_batch_import, vikunja_task_assignees), but some are just nouns (e.g., vikunja_labels, vikunja_projects). The vikunja_tasks tool is overly broad compared to others, creating a minor inconsistency.
With 16 tools, the server covers many aspects of task management, but the redundancy from vikunja_tasks duplicating other tools makes the count feel slightly inflated. Still, it remains within a reasonable range for a comprehensive API.
The tool set provides full CRUD for tasks, projects, labels, teams, and templates, plus advanced features like filters, webhooks, bulk operations, relations, reminders, and authentication. There are no obvious gaps for standard task management workflows.