mcpField
V
vikunja-mcp

vikunja-mcp

Local
github.com/AnthonyUttProductivity0Updated 22w ago
Repository

About vikunja-mcp

vikunja-mcp is a basic MCP server for interacting with the Vikunja to-do app. It supports project and task operations, with task creation limited to title, description, and done fields.

Key features

  1. 01List projects and retrieve one by ID
  2. 02List all tasks or tasks in a project
  3. 03Add tasks with title, description, and done fields
  4. 04Update tasks
  5. 05Delete tasks

Use cases

  1. 01Review projects and their tasks
  2. 02Add a task to a project
  3. 03Update or remove a task

MCP support

Exposes Vikunja project and task operations through an MCP server. MCP clients can list, add, update, and delete tasks, and retrieve project information.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "vikunja-mcp-anthonyutt": {
      "command": "npx",
      "args": [
        "-y",
        "vikunja-mcp"
      ],
      "env": {
        "VIKUNJA_API_BASE": "<VIKUNJA_API_BASE>",
        "VIKUNJA_API_TOKEN": "<VIKUNJA_API_TOKEN>"
      }
    }
  }
}
Run commandnpx -y vikunja-mcp
Environment variables to set
VIKUNJA_API_BASE
VIKUNJA_API_TOKENSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmvikunja-mcp

Tools

21

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project README

vikunja-mcp

Basic MCP server for Vikunja, maybe will add more features in the future

Currently Supported

  • List projects
  • Get project by ID
  • List all tasks
  • List tasks in project
  • Add task to project
    • N.B. - Only supports title, description, and done fields
  • Update task
  • Delete task

Installation

Via npx:

{
    "mcpServers": {
        // ... other config
        "vikunja": {
            "command": "npx",
            "args": [
                "-y",
                "vikunja-mcp"
            ],
            "env": [
                "VIKUNJA_API_BASE": "https://app.vikunja.cloud",
                "VIKUNJA_API_TOKEN": "<your_token_here>"
            ]
        }
    }
}

Or local build:

git clone https://github.com/AnthonyUtt/vikunja-mcp && cd vikunja-mcp
pnpm install
pnpm build

Then, in Claude config:

{
    "mcpServers": {
        // ... other config
        "vikunja": {
            "command": "node",
            "args": [
                "/path/to/dist/index.js"
            ],
            "env": [
                "VIKUNJA_API_BASE": "https://app.vikunja.cloud",
                "VIKUNJA_API_TOKEN": "<your_token_here>"
            ]
        }
    }
}

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.