Advertise
MCP.so
Sign In

Vikunja MCP Server

@AnthonyUtt

Repository

Basic information

Category

Other

Transports

stdio

Author

AnthonyUtt

About Vikunja MCP Server

Basic MCP server for interacting with Vikunja to-do app

Vikunja MCP Server 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": ""
      }
    }
  }
}

Vikunja MCP Server tools

21

List all projects

Get a specific project by ID

Create a new project

Update an existing project

Delete a project by ID

List all tasks across all projects

List all tasks for a specific project

Get a specific task by ID

Create a new task in a project

Update an existing task by ID

Delete a specific task by ID. This action cannot be undone, so use with caution.

Create a relation between two tasks

Delete a relation between two tasks

Get the comments for a specific task

Create a comment for a specific task

Update a comment for a specific task

Delete a comment for a specific task

List all attachments for a specific task

Attach a file to a task

Get a specific attachment for a task

Delete a specific attachment for a task

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

Frequently asked questions

1

What dependencies or runtime are required?

Node.js and either `npx` (for quick start) or a local clone with `pnpm` installed for building.

2

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.

3

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.

4

What are the limits of the "add task" operation?

Only the `title`, `description`, and `done` fields are supported when adding a task.

5

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.

Comments

More Other MCP servers

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Glasswarp

Glasswarp

See 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.

Activepieces

activepieces

AI 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

23.2K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K
Advertise