How do I use vikunja-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@vikunja-mcp list my tasks in project 'Work'" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

vikunja-mcp

by 0xK3vin

Overview Schema Related Servers Score Discussions

TypeScript

Remote

┌────────────────────────────────────────────────────────────┐
│                                                            │
│    ██╗   ██╗██╗██╗  ██╗██╗   ██╗███╗   ██╗     ██╗ █████╗  │
│    ██║   ██║██║██║ ██╔╝██║   ██║████╗  ██║     ██║██╔══██╗ │
│    ██║   ██║██║█████╔╝ ██║   ██║██╔██╗ ██║     ██║███████║ │
│    ╚██╗ ██╔╝██║██╔═██╗ ██║   ██║██║╚██╗██║██   ██║██╔══██║ │
│     ╚████╔╝ ██║██║  ██╗╚██████╔╝██║ ╚████║╚█████╔╝██║  ██║ │
│      ╚═══╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝ ╚════╝ ╚═╝  ╚═╝ │
│                        ███╗   ███╗ ██████╗██████╗          │
│                        ████╗ ████║██╔════╝██╔══██╗         │
│                        ██╔████╔██║██║     ██████╔╝         │
│                        ██║╚██╔╝██║██║     ██╔═══╝          │
│                        ██║ ╚═╝ ██║╚██████╗██║              │
│                        ╚═╝     ╚═╝ ╚═════╝╚═╝              │
│                                                            │
│    > MCP server for Vikunja task management                │
│    > Connect your AI assistant to your tasks               │
│                                                            │
└────────────────────────────────────────────────────────────┘

Build npm version License: MIT Node

> ABOUT

Connect your AI assistant to Vikunja, the open-source task manager. This MCP server lets you manage projects, tasks, kanban boards, and more—just by asking. Works with Claude Desktop, OpenCode, Cursor, and other MCP clients.

WHY VIKUNJA-MCP?
────────────────────────────────────────────────────────────
  [+] Self-hosted friendly    Your data stays on your server
  [+] Full coverage           32 tools across all Vikunja APIs
  [+] Reliable                Retry logic with exponential backoff
  [+] Production ready        86 tests, 90%+ code coverage
  [+] Zero config             Works out of the box with npx
────────────────────────────────────────────────────────────

> QUICK START

# Install
$ npm install -g @0xk3vin/vikunja-mcp

# Set environment variables
$ export VIKUNJA_URL="https://your-vikunja-instance.com"
$ export VIKUNJA_API_TOKEN="your_api_token"

Claude Desktop Configuration

Add to your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "vikunja": {
      "command": "npx",
      "args": ["-y", "@0xk3vin/vikunja-mcp"],
      "env": {
        "VIKUNJA_URL": "https://your-vikunja-instance.com",
        "VIKUNJA_API_TOKEN": "your_api_token"
      }
    }
  }
}

> FEATURES

┌─────────────────────────────────────────────────────────┐
│                                                         │
│  [■] PROJECTS      Create, update, delete, archive      │
│  [■] TASKS         Full CRUD + filtering & sorting      │
│  [■] KANBAN        Buckets, move tasks, WIP limits      │
│  [■] LABELS        Create, attach, remove from tasks    │
│  [■] COMMENTS      Add and list task comments           │
│  [■] ASSIGNEES     Manage who's working on what         │
│  [■] RELATIONS     Subtasks, blocking, dependencies     │
│  [■] VIEWS         List, kanban, table, gantt           │
│  [■] TEAMS         List teams and members               │
│  [■] USERS         Search by name, username, email      │
│  [■] NOTIFICATIONS List user notifications              │
│                                                         │
└─────────────────────────────────────────────────────────┘

> CONFIGURATION

Copy .env.example to .env and configure:

VIKUNJA_URL=https://your-vikunja-instance.com
VIKUNJA_API_TOKEN=your_api_token

Getting an API token:

Log into your Vikunja instance
Go to Settings → API Tokens
Create a new token and copy it

> DEVELOPMENT

$ git clone https://github.com/0xK3vin/vikunja-mcp.git
$ cd vikunja-mcp
$ npm install
$ npm run build
$ npm test

Commands

Command	Description
`npm start`	Run the server
`npm test`	Run tests
`npm run build`	Build TypeScript
`npm run lint`	Lint code
`npm run inspect`	Debug with MCP Inspector

> DOCS

Full API reference: docs/API.md

> CONTRIBUTING

Contributions welcome! See CONTRIBUTING.md for guidelines.

> LICENSE

MIT - see LICENSE

╔════════════════════════════════════════════════════════════╗
║  Made by 0xK3vin                                           ║
║  github.com/0xK3vin/vikunja-mcp                            ║
╚════════════════════════════════════════════════════════════╝

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

8wRelease cycle

3Releases (12mo)

Resources

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/0xK3vin/vikunja-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server