{"_id":"@0xk3vin/vikunja-mcp","_rev":"2-34df4d0b83af6ff5adcdf493abd19db7","name":"@0xk3vin/vikunja-mcp","dist-tags":{"latest":"1.2.0"},"versions":{"1.1.1":{"name":"@0xk3vin/vikunja-mcp","version":"1.1.1","keywords":["mcp","vikunja","model-context-protocol","task-management","productivity","ai"],"author":{"name":"0xK3vin"},"license":"MIT","_id":"@0xk3vin/vikunja-mcp@1.1.1","maintainers":[{"name":"0xk3vin","email":"kevinguzman8950@gmail.com"}],"homepage":"https://github.com/0xK3vin/vikunja-mcp#readme","bugs":{"url":"https://github.com/0xK3vin/vikunja-mcp/issues"},"bin":{"vikunja-mcp":"dist/index.js"},"dist":{"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},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"79f130cd33e3e321003788156aeb6c90e0920c5b","scripts":{"lint":"eslint src/","test":"vitest","build":"tsc","start":"tsx src/index.ts","format":"prettier --write src/","inspect":"npx @modelcontextprotocol/inspector tsx src/index.ts","prepare":"husky","test:ui":"vitest --ui","lint:fix":"eslint src/ --fix","test:run":"vitest run","typecheck":"tsc --noEmit","format:check":"prettier --check src/","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"_npmUser":{"name":"0xk3vin","email":"kevinguzman8950@gmail.com"},"repository":{"url":"git+https://github.com/0xK3vin/vikunja-mcp.git","type":"git"},"_npmVersion":"10.8.2","description":"MCP server for Vikunja task management","directories":{},"_nodeVersion":"20.19.6","dependencies":{"zod":"^4.3.5","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","husky":"^9.1.7","eslint":"^9.39.2","vitest":"^4.0.16","globals":"^17.0.0","prettier":"^3.7.4","@eslint/js":"^9.39.2","@vitest/ui":"^4.0.16","typescript":"^5.6.0","@types/node":"^22.0.0","lint-staged":"^16.2.7","typescript-eslint":"^8.52.0","@vitest/coverage-v8":"^4.0.16","eslint-config-prettier":"^10.1.8","@modelcontextprotocol/inspector":"^0.7.0"},"_npmOperationalInternal":{"tmp":"tmp/vikunja-mcp_1.1.1_1768081637138_0.9135209271763554","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"_id":"@0xk3vin/vikunja-mcp@1.2.0","bin":{"vikunja-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/0xK3vin/vikunja-mcp/issues"},"dist":{"shasum":"67519a70a5df4f0878b60485d5ea540bce603462","tarball":"https://registry.npmjs.org/@0xk3vin/vikunja-mcp/-/vikunja-mcp-1.2.0.tgz","fileCount":10,"integrity":"sha512-q2Sa2sTm81CA2Y3fW2NYY6LRS+TOdEiSfX8SFz4WUMOEsrJpPsPIRYo7nmNtt87LYOWpCzIkUNgXIdsZc7cZtw==","signatures":[{"sig":"MEQCID7I2uNdG7zoOCdqTFWe4VbRq5nc0tQHRGGcHWqLOJIPAiAmRV5+5yfxaGsBoTqlssSAwt29FyLdI88LQulE3vbN2g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCg2BZw5FjW2EKGQyzBZnWutf+NN1Zx0BBo7HBjtuh+aAIhANctuz+1w2yLzqZHMnVLCNze58mKbTTKhlICt5T2DN/G"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@0xk3vin%2fvikunja-mcp@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":51335},"main":"dist/index.js","name":"@0xk3vin/vikunja-mcp","type":"module","types":"./dist/index.d.ts","author":{"name":"0xK3vin"},"engines":{"node":">=18.0.0"},"gitHead":"d641511fd0ed9f31bd85318100f6cd3833202a8a","license":"MIT","scripts":{"lint":"eslint src/","test":"vitest","build":"tsc","start":"tsx src/index.ts","format":"prettier --write src/","inspect":"npx @modelcontextprotocol/inspector tsx src/index.ts","prepare":"husky","test:ui":"vitest --ui","lint:fix":"eslint src/ --fix","test:run":"vitest run","typecheck":"tsc --noEmit","format:check":"prettier --check src/","test:coverage":"vitest run --coverage","prepublishOnly":"npm run build"},"version":"1.2.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"965a47a9-8f48-42ed-ae25-d6355319f546"}},"homepage":"https://github.com/0xK3vin/vikunja-mcp#readme","keywords":["mcp","vikunja","model-context-protocol","task-management","productivity","ai"],"repository":{"url":"git+https://github.com/0xK3vin/vikunja-mcp.git","type":"git"},"_npmVersion":"11.19.0","description":"MCP server for Vikunja task management","directories":{},"maintainers":[{"name":"0xk3vin","email":"kevinguzman8950@gmail.com"}],"_nodeVersion":"24.21.0","dependencies":{"zod":"^4.3.5","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","husky":"^9.1.7","eslint":"^9.39.2","vitest":"^4.0.16","globals":"^17.0.0","prettier":"^3.7.4","@eslint/js":"^9.39.2","@vitest/ui":"^4.0.16","typescript":"^5.6.0","@types/node":"^22.0.0","lint-staged":"^16.2.7","typescript-eslint":"^8.52.0","@vitest/coverage-v8":"^4.0.16","eslint-config-prettier":"^10.1.8","@modelcontextprotocol/inspector":"^0.7.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/vikunja-mcp_1.2.0_1790970549673_0.6453266131293722"}}},"time":{"created":"2026-01-10T21:47:17.075Z","modified":"2026-10-02T19:49:10.019Z","1.1.1":"2026-01-10T21:47:17.264Z","1.2.0":"2026-10-02T19:49:09.754Z"},"bugs":{"url":"https://github.com/0xK3vin/vikunja-mcp/issues"},"author":{"name":"0xK3vin"},"license":"MIT","homepage":"https://github.com/0xK3vin/vikunja-mcp#readme","keywords":["mcp","vikunja","model-context-protocol","task-management","productivity","ai"],"repository":{"url":"git+https://github.com/0xK3vin/vikunja-mcp.git","type":"git"},"description":"MCP server for Vikunja task management","maintainers":[{"name":"0xk3vin","email":"kevinguzman8950@gmail.com"}],"readme":"```\n┌────────────────────────────────────────────────────────────┐\n│                                                            │\n│    ██╗   ██╗██╗██╗  ██╗██╗   ██╗███╗   ██╗     ██╗ █████╗  │\n│    ██║   ██║██║██║ ██╔╝██║   ██║████╗  ██║     ██║██╔══██╗ │\n│    ██║   ██║██║█████╔╝ ██║   ██║██╔██╗ ██║     ██║███████║ │\n│    ╚██╗ ██╔╝██║██╔═██╗ ██║   ██║██║╚██╗██║██   ██║██╔══██║ │\n│     ╚████╔╝ ██║██║  ██╗╚██████╔╝██║ ╚████║╚█████╔╝██║  ██║ │\n│      ╚═══╝  ╚═╝╚═╝  ╚═╝ ╚═════╝ ╚═╝  ╚═══╝ ╚════╝ ╚═╝  ╚═╝ │\n│                        ███╗   ███╗ ██████╗██████╗          │\n│                        ████╗ ████║██╔════╝██╔══██╗         │\n│                        ██╔████╔██║██║     ██████╔╝         │\n│                        ██║╚██╔╝██║██║     ██╔═══╝          │\n│                        ██║ ╚═╝ ██║╚██████╗██║              │\n│                        ╚═╝     ╚═╝ ╚═════╝╚═╝              │\n│                                                            │\n│    > MCP server for Vikunja task management                │\n│    > Connect your AI assistant to your tasks               │\n│                                                            │\n└────────────────────────────────────────────────────────────┘\n```\n\n[![Build](https://github.com/0xK3vin/vikunja-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/0xK3vin/vikunja-mcp/actions/workflows/ci.yml)\n[![npm version](https://img.shields.io/npm/v/@0xk3vin/vikunja-mcp.svg)](https://www.npmjs.com/package/@0xk3vin/vikunja-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![Node](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)\n\n---\n\n## > ABOUT\n\nConnect your AI assistant to [Vikunja](https://vikunja.io), the open-source task manager. This [MCP](https://modelcontextprotocol.io) server lets you manage projects, tasks, kanban boards, and more—just by asking. Works with Claude Desktop, OpenCode, Cursor, and other MCP clients.\n\n```\nWHY VIKUNJA-MCP?\n────────────────────────────────────────────────────────────\n  [+] Self-hosted friendly    Your data stays on your server\n  [+] Full coverage           32 tools across all Vikunja APIs\n  [+] Reliable                Retry logic with exponential backoff\n  [+] Production ready        86 tests, 90%+ code coverage\n  [+] Zero config             Works out of the box with npx\n────────────────────────────────────────────────────────────\n```\n\n---\n\n## > QUICK START\n\n```bash\n# Install\n$ npm install -g @0xk3vin/vikunja-mcp\n\n# Set environment variables\n$ export VIKUNJA_URL=\"https://your-vikunja-instance.com\"\n$ export VIKUNJA_API_TOKEN=\"your_api_token\"\n```\n\n### Claude Desktop Configuration\n\nAdd to your config file:\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"vikunja\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@0xk3vin/vikunja-mcp\"],\n      \"env\": {\n        \"VIKUNJA_URL\": \"https://your-vikunja-instance.com\",\n        \"VIKUNJA_API_TOKEN\": \"your_api_token\"\n      }\n    }\n  }\n}\n```\n\n---\n\n## > FEATURES\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                                                         │\n│  [■] PROJECTS      Create, update, delete, archive      │\n│  [■] TASKS         Full CRUD + filtering & sorting      │\n│  [■] KANBAN        Buckets, move tasks, WIP limits      │\n│  [■] LABELS        Create, attach, remove from tasks    │\n│  [■] COMMENTS      Add and list task comments           │\n│  [■] ASSIGNEES     Manage who's working on what         │\n│  [■] RELATIONS     Subtasks, blocking, dependencies     │\n│  [■] VIEWS         List, kanban, table, gantt           │\n│  [■] TEAMS         List teams and members               │\n│  [■] USERS         Search by name, username, email      │\n│  [■] NOTIFICATIONS List user notifications              │\n│                                                         │\n└─────────────────────────────────────────────────────────┘\n```\n\n---\n\n## > CONFIGURATION\n\nCopy `.env.example` to `.env` and configure:\n\n```bash\nVIKUNJA_URL=https://your-vikunja-instance.com\nVIKUNJA_API_TOKEN=your_api_token\n```\n\n**Getting an API token:**\n1. Log into your Vikunja instance\n2. Go to **Settings** → **API Tokens**\n3. Create a new token and copy it\n\n---\n\n## > DEVELOPMENT\n\n```bash\n$ git clone https://github.com/0xK3vin/vikunja-mcp.git\n$ cd vikunja-mcp\n$ npm install\n$ npm run build\n$ npm test\n```\n\n### Commands\n\n| Command | Description |\n|---------|-------------|\n| `npm start` | Run the server |\n| `npm test` | Run tests |\n| `npm run build` | Build TypeScript |\n| `npm run lint` | Lint code |\n| `npm run inspect` | Debug with MCP Inspector |\n\n---\n\n## > DOCS\n\nFull API reference: **[docs/API.md](docs/API.md)**\n\n---\n\n## > CONTRIBUTING\n\nContributions welcome! See **[CONTRIBUTING.md](CONTRIBUTING.md)** for guidelines.\n\n---\n\n## > LICENSE\n\nMIT - see [LICENSE](LICENSE)\n\n---\n\n```\n╔════════════════════════════════════════════════════════════╗\n║  Made by 0xK3vin                                           ║\n║  github.com/0xK3vin/vikunja-mcp                            ║\n╚════════════════════════════════════════════════════════════╝\n```\n","readmeFilename":"README.md"}