About Vikunja
Vikunja is an MCP server published by 0xK3vin in the Productivity category: mCP server for Vikunja task management.
The repository has 17 stars and 11 forks, with the last commit 19 days ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
Claude Code
claude mcp add vikunja-7867 -- npx -y @0xk3vin/vikunja-mcpnpx
npx -y @0xk3vin/vikunja-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
✦
Ask AI about Vikunja
Powered by Claude · Grounded in docs
I know everything about Vikunja. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
Static checks derived from the repository just now. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- ✓License declaredUsable under a stated license.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
1 check has not been run yet.
Releases
v1.2.0-publishnpm 1.2.0 publication · 2 Oct 2026Publication-trigger release for `@0xk3vin/vikunja-mcp@1.2.0` from reviewed commit `d641511fd0ed9f31bd85318100f6cd3833202a8a`, using the existing GitHub Actions npm trusted-publishing workflow. The original `v1.2.0` tag and release are…
v1.2.0v1.2.0 · 9 May 2026Changes Fix Vikunja task listing compatibility for Vikunja 1.0+ by using `/tasks` instead of the removed `/tasks/all` endpoint. Bump npm package version to `1.2.0`.
v1.1.1v1.1.1 · 10 Jan 2026First Public Release Vikunja-MCP brings your AI assistant and task management together. What's Included 32 MCP Tools covering the full Vikunja API: Projects, Tasks, Labels, Kanban boards Comments, Assignees, Relations Views, Teams, Users,…
v1.1.0v1.1.0 · 10 Jan 2026First Public Release Vikunja-MCP brings your AI assistant and task management together. What's Included 32 MCP Tools covering the full Vikunja API: Projects, Tasks, Labels, Kanban boards Comments, Assignees, Relations Views, Teams, Users,…
README
┌────────────────────────────────────────────────────────────┐
│ │
│ ██╗ ██╗██╗██╗ ██╗██╗ ██╗███╗ ██╗ ██╗ █████╗ │
│ ██║ ██║██║██║ ██╔╝██║ ██║████╗ ██║ ██║██╔══██╗ │
│ ██║ ██║██║█████╔╝ ██║ ██║██╔██╗ ██║ ██║███████║ │
│ ╚██╗ ██╔╝██║██╔═██╗ ██║ ██║██║╚██╗██║██ ██║██╔══██║ │
│ ╚████╔╝ ██║██║ ██╗╚██████╔╝██║ ╚████║╚█████╔╝██║ ██║ │
│ ╚═══╝ ╚═╝╚═╝ ╚═╝ ╚═════╝ ╚═╝ ╚═══╝ ╚════╝ ╚═╝ ╚═╝ │
│ ███╗ ███╗ ██████╗██████╗ │
│ ████╗ ████║██╔════╝██╔══██╗ │
│ ██╔████╔██║██║ ██████╔╝ │
│ ██║╚██╔╝██║██║ ██╔═══╝ │
│ ██║ ╚═╝ ██║╚██████╗██║ │
│ ╚═╝ ╚═╝ ╚═════╝╚═╝ │
│ │
│ > MCP server for Vikunja task management │
│ > Connect your AI assistant to your tasks │
│ │
└────────────────────────────────────────────────────────────┘
> 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 ║
╚════════════════════════════════════════════════════════════╝
README fetched from the repository just now. The original is authoritative.