vikunja-mcp
@AnthonyUtt
About vikunja-mcp
Basic MCP server for interacting with Vikunja to-do app
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"vikunja": {
"command": "npx",
"args": [
"-y",
"vikunja-mcp"
],
"env": {
"VIKUNJA_API_BASE": "https://app.vikunja.cloud",
"VIKUNJA_API_TOKEN": ""
}
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is vikunja-mcp?
vikunja-mcp is a basic Model Context Protocol server for Vikunja, a task management platform. It enables AI assistants like Claude to interact with Vikunja to manage projects and tasks.
How to use vikunja-mcp?
Install it via npx or build locally, then configure your MCP client with the vikunja-mcp command and environment variables VIKUNJA_API_BASE and VIKUNJA_API_TOKEN. For example, add a "vikunja" entry under mcpServers in your Claude configuration.
Key features of vikunja-mcp
- List all projects
- Get a project by its ID
- List all tasks across projects
- List tasks within a specific project
- Add a task with title, description, and done fields
- Update and delete existing tasks
Use cases of vikunja-mcp
- List all projects and their details
- View tasks in a specific project
- Add new tasks to a project
- Update or delete tasks via conversation
FAQ from vikunja-mcp
What dependencies or runtime are required?
Node.js and either npx (for quick start) or a local clone with pnpm installed for building.
How does authentication work?
You provide a Vikunja API token via the VIKUNJA_API_TOKEN environment variable. The token must have appropriate permissions for the operations you intend to use.
What transport does the server use?
It runs as a subprocess via stdio – the command and arguments are specified in the client’s MCP server configuration.
What are the limits of the "add task" operation?
Only the title, description, and done fields are supported when adding a task.
Where are my data stored?
All data resides in your Vikunja instance, which is accessed via the VIKUNJA_API_BASE URL you configure. The server does not store anything locally.
Frequently asked questions
What dependencies or runtime are required?
Node.js and either `npx` (for quick start) or a local clone with `pnpm` installed for building.
How does authentication work?
You provide a Vikunja API token via the `VIKUNJA_API_TOKEN` environment variable. The token must have appropriate permissions for the operations you intend to use.
What transport does the server use?
It runs as a subprocess via `stdio` – the command and arguments are specified in the client’s MCP server configuration.
What are the limits of the "add task" operation?
Only the `title`, `description`, and `done` fields are supported when adding a task.
Where are my data stored?
All data resides in your Vikunja instance, which is accessed via the `VIKUNJA_API_BASE` URL you configure. The server does not store anything locally.
Basic information
More Other MCP servers
Nginx UI
0xJackyYet another WebUI for Nginx
Inbox Zero AI
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
AutoBrowser MCP
autobrowser-aiBrowser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser
Production-ready MCP integrations for AI applications
Klavis-AIKlavis AI: MCP integration platforms that let AI agents use tools reliably at any scale
Comments