vikunja-mcp

Overview

Vikunja MCP server is a robust implementation that enables AI assistants to interact with Vikunja task management systems. It offers extensive functionality including task management, project operations, label management, team collaboration, webhook automation, and batch import capabilities. The recent v0.2.0 release brought significant architectural improvements with 90% code reduction, enhanced security through Zod-based validation, and production-ready retry logic using opossum circuit breaker patterns.

Try asking AI

After installing, here are 7 things you can ask your AI assistant:

• vikunja_auth

  Manages authentication with Vikunja instance via API tokens or JWT

  Try:Connect to my Vikunja instance with API tokenTry:Check if I'm authenticated to VikunjaTry:Disconnect from Vikunja
• vikunja_tasks

  Manages task operations including create, read, update, delete, and bulk operations

  Try:List all my tasks with high priorityTry:Create a new task with due date tomorrowTry:Update task 123 to mark as done
• vikunja_projects

  Manages project operations including create, read, update, delete, and hierarchy

  Try:List all my projectsTry:Create a new project called 'Q4 Planning'Try:Update project 5 with a new description
• vikunja_labels

  Manages label operations for task organization

  Try:List all available labelsTry:Create a new label called 'urgent'Try:Update label 3 with color '#FF0000'
• vikunja_teams

  Manages team operations including create, read, update, and member management

  Try:List all teams in my organizationTry:Create a new team called 'Developers'Try:Update team 5 with a new description
• vikunja_users

  Manages user operations including search, settings, and profile updates (JWT only)

  Try:Find users with name 'John'Try:Get user settings for user 5Try:Update user profile for user 8
• vikunja_webhooks

  Manages webhook operations for project automation

  Try:List all webhooks for project 5Try:Create a new webhook for task updatesTry:Update webhook 7 with a new URL
• vikunja_batch_import

  Imports tasks in bulk from CSV or JSON formats

  Try:Import tasks from this CSV fileTry:Bulk create tasks from JSON dataTry:Validate import without creating tasks
• vikunja_export_project

  Exports project data including tasks and child projects (JWT only)

  Try:Export project 5 with all its dataTry:Export project 5 including all child projectsTry:Get JSON data for project 8

Comparable tools

Installation

{
  "vikunja": {
    "command": "npx",
    "args": ["-y", "@democratize-technology/vikunja-mcp"],
    "env": {
      "VIKUNJA_URL": "https://your-vikunja-instance.com/api/v1",
      "VIKUNJA_API_TOKEN": "your-api-token"
    }
  }
}

git clone https://github.com/democratize-technology/vikunja-mcp.git
cd vikunja-mcp
npm install
npm run build

FAQ

What authentication methods are supported?

The server supports both API tokens (starting with 'tk_') and JWT tokens. API tokens provide full access to tasks, projects, labels, teams, and webhooks, while JWT tokens enable additional user management and export capabilities.

How do I get a JWT token for authentication?

Log into your Vikunja instance in a web browser, open Developer Tools (F12), go to Application/Storage tab, find the JWT token in Local Storage under your Vikunja domain, and copy the entire value.

What are the system requirements?

Node.js 20+ (LTS versions only) and a Vikunja instance with API access. The server has undergone significant architectural improvements in v0.2.0 with 90% code reduction and enhanced security features.

Compare vikunja-mcp with