vikunja-mcp

Name: vikunja-mcp
Author: AnthonyUtt

@AnthonyUtt

代码仓库

关于 vikunja-mcp

Basic MCP server for interacting with Vikunja to-do app

基本信息

分类

其他

运行时

node

传输方式

stdio

发布者

AnthonyUtt

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.