Back to packageRELEASE DETAILS

1.1.1

npm

@0xk3vin/vikunja-mcp

MCP server for Vikunja task management

Published10 Jan 2026

Direct dependencies17

Transitive dependenciesNot calculated

README

Current package documentation

┌────────────────────────────────────────────────────────────┐
│                                                            │
│    ██╗   ██╗██╗██╗  ██╗██╗   ██╗███╗   ██╗     ██╗ █████╗  │
│    ██║   ██║██║██║ ██╔╝██║   ██║████╗  ██║     ██║██╔══██╗ │
│    ██║   ██║██║█████╔╝ ██║   ██║██╔██╗ ██║     ██║███████║ │
│    ╚██╗ ██╔╝██║██╔═██╗ ██║   ██║██║╚██╗██║██   ██║██╔══██║ │
│     ╚████╔╝ ██║██║  ██╗╚██████╔╝██║ ╚████║╚█████╔╝██║  ██║ │
│      ╚═══╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝ ╚════╝ ╚═╝  ╚═╝ │
│                        ███╗   ███╗ ██████╗██████╗          │
│                        ████╗ ████║██╔════╝██╔══██╗         │
│                        ██╔████╔██║██║     ██████╔╝         │
│                        ██║╚██╔╝██║██║     ██╔═══╝          │
│                        ██║ ╚═╝ ██║╚██████╗██║              │
│                        ╚═╝     ╚═╝ ╚═════╝╚═╝              │
│                                                            │
│    > 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                            ║
╚════════════════════════════════════════════════════════════╝

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 17

Native requirements

17 direct targetsNot calculated transitive count

Package / target	Requirement	Relationship
zod Environment { "local_name": "zod", "alias": false, "peer_metadata": null }	`^4.3.5`	runtime
@modelcontextprotocol/sdk Environment { "local_name": "@modelcontextprotocol/sdk", "alias": false, "peer_metadata": null }	`^1.0.0`	runtime
tsx Environment { "local_name": "tsx", "alias": false, "peer_metadata": null }	`^4.19.0`	development
husky Environment { "local_name": "husky", "alias": false, "peer_metadata": null }	`^9.1.7`	development
eslint Environment { "local_name": "eslint", "alias": false, "peer_metadata": null }	`^9.39.2`	development
vitest Environment { "local_name": "vitest", "alias": false, "peer_metadata": null }	`^4.0.16`	development
globals Environment { "local_name": "globals", "alias": false, "peer_metadata": null }	`^17.0.0`	development
prettier Environment { "local_name": "prettier", "alias": false, "peer_metadata": null }	`^3.7.4`	development
@eslint/js Environment { "local_name": "@eslint/js", "alias": false, "peer_metadata": null }	`^9.39.2`	development
@vitest/ui Environment { "local_name": "@vitest/ui", "alias": false, "peer_metadata": null }	`^4.0.16`	development
typescript Environment { "local_name": "typescript", "alias": false, "peer_metadata": null }	`^5.6.0`	development
@types/node Environment { "local_name": "@types/node", "alias": false, "peer_metadata": null }	`^22.0.0`	development
lint-staged Environment { "local_name": "lint-staged", "alias": false, "peer_metadata": null }	`^16.2.7`	development
typescript-eslint Environment { "local_name": "typescript-eslint", "alias": false, "peer_metadata": null }	`^8.52.0`	development
@vitest/coverage-v8 Environment { "local_name": "@vitest/coverage-v8", "alias": false, "peer_metadata": null }	`^4.0.16`	development
eslint-config-prettier Environment { "local_name": "eslint-config-prettier", "alias": false, "peer_metadata": null }	`^10.1.8`	development
@modelcontextprotocol/inspector Environment { "local_name": "@modelcontextprotocol/inspector", "alias": false, "peer_metadata": null }	`^0.7.0`	development

Distribution files

1 collected

Distribution 1

Source distribution

Source file

Checksums from source

{
  "shasum": "3ecfdb6a25f04713c779638b5ca88f8d828ee413",
  "tarball": "https://registry.npmjs.org/@0xk3vin/vikunja-mcp/-/vikunja-mcp-1.1.1.tgz",
  "fileCount": 10,
  "integrity": "sha512-qGB3KCRyoxmZInDgOdV/d5WloKL8lXt+HEpttqYZmgPXrWfxPCMETvgW2sFNy+Bcf2v4cAjAzIjnz49pOGS1Ow==",
  "signatures": [
    {
      "sig": "MEUCIQCKJwCIe8ToqXwEDW83cUnZJ2UyAZmnSXS1HwWz1ZuwTAIgF8gTbLKWpkDs2MFk0GUV0JAWf4nTtTutUfO5wWG9tqM=",
      "keyid": "SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"
    }
  ],
  "unpackedSize": 51339
}

Repository

PENDING

0xk3vin/vikunja-mcp

Shared repository data · GitHub

License detected in repository: Not collected

Metadata history

Meaningful changes

Current collected state Current

Observed since 21 Oct, 08:58 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:78187ea6f94e34e861d2b07ab7104d5db607d774d510596c5affbaf89ed9027a

Other collected versions

1.2.02 Oct View all collected versions →