vikunja-mcp

MCP server for Vikunja task management. Lightweight API wrapper — no auth dance, just works.

Tools

Tool	Description
list_projects	List all projects
get_project	Get project by ID
create_project	Create a new project
update_project	Update a project
delete_project	Delete a project
list_tasks	List/filter/search tasks
get_task	Get task by ID
create_task	Create a task
update_task	Update a task
delete_task	Delete a task
bulk_create_tasks	Create multiple tasks at once
list_labels	List all labels
create_label	Create a label
add_label_to_task	Tag a task with a label
remove_label_from_task	Remove label from task
list_comments	List task comments
add_comment	Comment on a task

Setup

Claude Code (~/.claude.json)

{
  "mcpServers": {
    "vikunja": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "vikunja-mcp"],
      "env": {
        "VIKUNJA_API_URL": "http://your-instance/api/v1",
        "VIKUNJA_API_TOKEN": "tk_your_token_here"
      }
    }
  }
}

From source

git clone https://github.com/ugoi/vikunja-mcp.git
cd vikunja-mcp
npm install && npm run build
VIKUNJA_API_URL=http://localhost:3456/api/v1 VIKUNJA_API_TOKEN=tk_xxx node dist/index.js

Get an API token

Vikunja UI: Settings > API Tokens > Create Token

Grant permissions for: tasks, projects, labels (each: read_all, create, update, delete).

License

MIT