vikunja

This MCP server provides an integration to Vikunja, the open-source task management platform. It exposes Vikunja's project, task, kanban, and user-related operations as MCP tools, enabling your AI assistants to create, update, query, and organize tasks and boards in Vikunja through natural language prompts. With support for 32 tools across Vikunja APIs, you can manage projects, tasks, labels, assignees, comments, relations, views, teams, and more, all via MCP clients such as Claude Desktop, OpenCode, Cursor, and other MCP-enabled interfaces. To get started, point the MCP server at your Vikunja instance by configuring the required environment variables and running the server through the provided npx command, which handles installation of the MCP package and runtime startup. You can then use the MCP client to issue commands like creating a task, moving a task to a kanban column, or listing all tasks in a project, and the server will translate those requests into Vikunja API calls and return structured results.

Prerequisites:\n- Node.js v18 or newer (as indicated by the project badge)\n- npm (comes with Node.js)\n- Access to a Vikunja instance with an API token\n\nInstall and run:\nbash\n# Install the MCP package globally via npx (as described by the project)\n# This will install and run the Vikunja MCP server from the npm package\n# You can also install locally if you prefer: npm install -g @0xk3vin/vikunja-mcp\n\n# Start the server (npx handles installation and execution)\nnpx -y @0xk3vin/vikunja-mcp\n \nConfigure required environment variables (example):\nbash\nexport VIKUNJA_URL="https://your-vikunja-instance.com"\nexport VIKUNJA_API_TOKEN="your_api_token"\n \nOptionally, for Claude Desktop configuration, create or update the config file to point to the MCP server (as shown in the Quick Start):\njson\n{\n "mcpServers": {\n "vikunja": {\n "command": "npx",\n "args": ["-y", "@0xk3vin/vikunja-mcp"],\n "env": {\n "VIKUNJA_URL": "https://your-vikunja-instance.com",\n "VIKUNJA_API_TOKEN": "your_api_token"\n }\n }\n }\n}\n

Tips and caveats:\n- Ensure VIKUNJA_URL uses the correct scheme (http(s)://) and that the API token has the necessary scopes for the operations you intend to perform.\n- The MCP server tests and builds are run in CI, so most environments should work with Node.js 18+. If you encounter network or token issues, verify that the Vikunja instance is reachable from the host running the MCP server.\n- If you run into issues with npx installation, you can explicitly install the package and run the server with a local node invocation.\n- When using Claude Desktop, update the claude_desktop_config.json to include the Vikunja MCP server with the provided environment variables.\n- The server supports a broad set of Vikunja operations; consult the docs/API.md in the repository for exact tool mappings and usage details.