Vikunja MCP Server
@democratize-technology
About Vikunja MCP Server
Model Context Protocol server for Vikunja task management. Enables AI assistants to interact with Vikunja instances via MCP.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"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"
}
}
}
}Tools
9Overview
What is Vikunja MCP Server?
A Model Context Protocol (MCP) server that enables AI assistants to interact with Vikunja task management instances. It provides subcommand-based tools for full task, project, label, team, user, and webhook management.
How to use Vikunja MCP Server?
Install via npx -y @democratize-technology/vikunja-mcp or build locally, then configure environment variables VIKUNJA_URL and VIKUNJA_API_TOKEN (or JWT token) in your MCP client. Use subcommand tools like vikunja_tasks.create and vikunja_auth.connect after authentication.
Key features of Vikunja MCP Server
- Subcommand-based tools for intuitive AI interactions
- Full task, project, label, and team management
- Batch import tasks from CSV or JSON files
- Zod-based input validation and DoS protection
- Production‑ready retry logic with circuit breaker
- Automatic API token or JWT detection
Use cases of Vikunja MCP Server
- Automate task creation and updates via AI assistants
- Manage projects and labels through natural language commands
- Bulk import tasks from CSV/JSON files into Vikunja
- Retrieve and organize tasks with advanced filtering and sorting
FAQ from Vikunja MCP Server
What authentication methods are supported?
Supports API tokens (starting with tk_) for most operations and JWT tokens (starting with eyJ) for full access including user management and export. Token type is automatically detected.
What are the runtime requirements?
Requires Node.js 20+ (LTS only) and an existing Vikunja instance with API access.
How do I obtain an API token?
Go to Vikunja Settings → API Tokens → Create new token. The token format starts with tk_.
Are there rate limits or memory protections?
Yes, the server includes configurable rate limiting against DoS attacks and memory protection with pagination limits and usage monitoring.
Can I use JWT tokens for user management?
Yes, JWT tokens enable access to user‑specific endpoints (profile, settings, export) which are not available with API tokens.
Frequently asked questions
What authentication methods are supported?
Supports API tokens (starting with `tk_`) for most operations and JWT tokens (starting with `eyJ`) for full access including user management and export. Token type is automatically detected.
What are the runtime requirements?
Requires Node.js 20+ (LTS only) and an existing Vikunja instance with API access.
How do I obtain an API token?
Go to Vikunja Settings → API Tokens → Create new token. The token format starts with `tk_`.
Are there rate limits or memory protections?
Yes, the server includes configurable rate limiting against DoS attacks and memory protection with pagination limits and usage monitoring.
Can I use JWT tokens for user management?
Yes, JWT tokens enable access to user‑specific endpoints (profile, settings, export) which are not available with API tokens.
Basic information
More Other MCP servers
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
Maestro
mobile-dev-incPainless E2E Automation for Mobile and Web
Glasswarp
GlasswarpSee and control a real Windows PC you own — from any MCP client, locally or remotely. Observe (UIA + screenshots), click/type/drag/scroll, launch apps, owner Live View. BYOH: your machine, your key.
Comments