{"_id":"@ainovix/taskmanager-mcp","_rev":"6-a7c9dd3676dfb019f058baaa69412b8f","name":"@ainovix/taskmanager-mcp","dist-tags":{"latest":"1.3.0"},"versions":{"1.0.0":{"name":"@ainovix/taskmanager-mcp","version":"1.0.0","keywords":["mcp","taskmanager","ai","model-context-protocol","task-management"],"author":{"name":"AINOVIX"},"license":"MIT","_id":"@ainovix/taskmanager-mcp@1.0.0","maintainers":[{"name":"ryze_23x","email":"andres.guaglianone@ainovix.de"}],"homepage":"https://github.com/ainovix/taskmanager#readme","bugs":{"url":"https://github.com/ainovix/taskmanager/issues"},"bin":{"taskmanager-mcp":"dist/index.js"},"dist":{"shasum":"682e0e08cad5f2f7f048a0df0dc637744873ca5c","tarball":"https://registry.npmjs.org/@ainovix/taskmanager-mcp/-/taskmanager-mcp-1.0.0.tgz","fileCount":17,"integrity":"sha512-MSTVUteD44Qj4EiCss4DbzxTaOlzbqTYZIQdKGJbL2d9XBkVv4fs7sSLDQYkfkIM1I4zmMAcnuSn3s3BwryQwA==","signatures":[{"sig":"MEYCIQCg5K7iJdb0WiqGUMLXnPqci0kdIhGiLVotvfwuFutG9QIhAOLk5kFwUQ9WB8OrlSMYC50hAv+jnEdD7Wb1UxOOhAyA","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52139},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"d4c5d21d493942eeafc7c4c789cfe17da0a528fc","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"ryze_23x","email":"andres.guaglianone@ainovix.de"},"repository":{"url":"git+https://github.com/ainovix/taskmanager.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.6.2","description":"MCP server for TaskManager — exposes task management as AI-consumable tools","directories":{},"_nodeVersion":"22.17.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.0","typescript":"^5.7.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/taskmanager-mcp_1.0.0_1782501129661_0.8761599611436945","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@ainovix/taskmanager-mcp","version":"1.1.0","keywords":["mcp","taskmanager","ai","model-context-protocol","task-management"],"author":{"name":"AINOVIX"},"license":"MIT","_id":"@ainovix/taskmanager-mcp@1.1.0","maintainers":[{"name":"ryze_23x","email":"andres.guaglianone.ainovix@gmail.com"},{"name":"johnlee1501","email":"jhonjhad@gmail.com"}],"homepage":"https://github.com/ainovix/taskmanager#readme","bugs":{"url":"https://github.com/ainovix/taskmanager/issues"},"bin":{"taskmanager-mcp":"dist/index.js"},"dist":{"shasum":"2fa514135b7709c086dc1f846c6daa91ceb25df3","tarball":"https://registry.npmjs.org/@ainovix/taskmanager-mcp/-/taskmanager-mcp-1.1.0.tgz","fileCount":17,"integrity":"sha512-hJFlJ3PR8N101Z8TKOBQFuM7ZfIYSa9mcVyz4sbi/siC3I3Mo8G/xk8MHrSew4vTuXgpdsnF03DGcnrXKC52Lg==","signatures":[{"sig":"MEQCIAE+J7f1Sv57NWTsNuBiGgMPL89zEcpREX0BoJBTtnITAiAQh8BPD6uo0+d4NeMWgUeFWCYF8cvLDlhQtaMmqdtuDw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55253},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"44d9863b4518c08e9c5b29208b509d6c48fbf4b4","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"ryze_23x","email":"andres.guaglianone.ainovix@gmail.com"},"repository":{"url":"git+https://github.com/ainovix/taskmanager.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.6.2","description":"MCP server for TaskManager — exposes task management as AI-consumable tools","directories":{},"_nodeVersion":"22.17.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.0","typescript":"^5.7.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/taskmanager-mcp_1.1.0_1785251217585_0.9383743194201473","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"@ainovix/taskmanager-mcp","version":"1.1.1","keywords":["mcp","taskmanager","ai","model-context-protocol","task-management"],"author":{"name":"AINOVIX"},"license":"MIT","_id":"@ainovix/taskmanager-mcp@1.1.1","maintainers":[{"name":"ryze_23x","email":"andres.guaglianone.ainovix@gmail.com"},{"name":"johnlee1501","email":"jhonjhad@gmail.com"}],"homepage":"https://github.com/ainovix/taskmanager#readme","bugs":{"url":"https://github.com/ainovix/taskmanager/issues"},"bin":{"taskmanager-mcp":"dist/index.js"},"dist":{"shasum":"2e792c5fe323f633f11f2954932cb9f36f5ef0d8","tarball":"https://registry.npmjs.org/@ainovix/taskmanager-mcp/-/taskmanager-mcp-1.1.1.tgz","fileCount":17,"integrity":"sha512-4Qxhsiu9vdPuGwWu35cNpTCT6rqnoS/Q8r9jf39EagKU654y7Ht2o7Cn1RgUK9sBYFQOAseSH4WJu309Zufp8A==","signatures":[{"sig":"MEYCIQDfOne6uApUPb4htWn+EB/0eGkt6+8orrmbZFugN7+rpwIhAN2AnTpD7S1NqKoIUkeVR5QdYxoY1OI0umxRR3Rni4Qy","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55738},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"ece7c9d9939e8ca1039da7455c6e5d70838edfd2","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"ryze_23x","email":"andres.guaglianone.ainovix@gmail.com"},"repository":{"url":"git+https://github.com/ainovix/taskmanager.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.6.2","description":"MCP server for TaskManager — exposes task management as AI-consumable tools","directories":{},"_nodeVersion":"22.17.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.0","typescript":"^5.7.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/taskmanager-mcp_1.1.1_1785420250682_0.8830568749329297","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@ainovix/taskmanager-mcp","version":"1.2.0","keywords":["mcp","taskmanager","ai","model-context-protocol","task-management"],"author":{"name":"AINOVIX"},"license":"MIT","_id":"@ainovix/taskmanager-mcp@1.2.0","maintainers":[{"name":"ryze_23x","email":"andres.guaglianone.ainovix@gmail.com"},{"name":"johnlee1501","email":"jhonjhad@gmail.com"}],"homepage":"https://github.com/ainovix/taskmanager#readme","bugs":{"url":"https://github.com/ainovix/taskmanager/issues"},"bin":{"taskmanager-mcp":"dist/index.js"},"dist":{"shasum":"9ac35b655c70ce3cd5c0cf96fbe2a6e250c841fa","tarball":"https://registry.npmjs.org/@ainovix/taskmanager-mcp/-/taskmanager-mcp-1.2.0.tgz","fileCount":17,"integrity":"sha512-iJyjmkmGa1tbSj0VwqjaMqr/p+PtPNRRY2KbKZ6ugmZdggR9jDalGpuy3hSFc2S6AdbpWPJmvvexgvF9AiIViA==","signatures":[{"sig":"MEUCIQDo5mnWlMXW+nzbMXwHJ4p4FwIsnNO1jzxp22hBGO6mIAIgQ3CWHOPofZ3oz5pyxSndKBSyL6BWgwLZtmGuN6pAbo0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":70207},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"4ef652ab14de7e72091882b054fbc744d9c95338","scripts":{"dev":"tsc --watch","test":"vitest run","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"ryze_23x","email":"andres.guaglianone.ainovix@gmail.com"},"repository":{"url":"git+https://github.com/ainovix/taskmanager.git","type":"git","directory":"packages/mcp-server"},"_npmVersion":"11.6.2","description":"MCP server for TaskManager — exposes task management as AI-consumable tools","directories":{},"_nodeVersion":"22.17.0","dependencies":{"zod":"^3.24.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.0","typescript":"^5.7.0","@types/node":"^20.0.0"},"_npmOperationalInternal":{"tmp":"tmp/taskmanager-mcp_1.2.0_1785451886805_0.09184839427050462","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"name":"@ainovix/taskmanager-mcp","version":"1.3.0","description":"MCP server for TaskManager — exposes task management as AI-consumable tools","type":"module","main":"dist/index.js","bin":{"taskmanager-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","test":"vitest run"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0","zod":"^3.24.0"},"devDependencies":{"@types/node":"^20.0.0","typescript":"^5.7.0","vitest":"^4.0.0"},"engines":{"node":">=18.0.0"},"repository":{"type":"git","url":"git+https://github.com/ainovix/taskmanager.git","directory":"packages/mcp-server"},"author":{"name":"AINOVIX"},"license":"MIT","keywords":["mcp","taskmanager","ai","model-context-protocol","task-management"],"homepage":"https://github.com/ainovix/taskmanager#readme","bugs":{"url":"https://github.com/ainovix/taskmanager/issues"},"publishConfig":{"access":"public"},"gitHead":"f1e20b8889f16a863a1ed9d37a9352c41fe18434","types":"./dist/index.d.ts","_id":"@ainovix/taskmanager-mcp@1.3.0","_nodeVersion":"22.17.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-OfeKiyxccbv0zUZ17Feu31XL1TQAuepc7+kGtFFkcmzpggK74t/WJICNNe994QiQ0TUjVOkYWOquZAeXI0D+1g==","shasum":"86e29b421b4a2db3e8a5875cee0cb9c1f226197b","tarball":"https://registry.npmjs.org/@ainovix/taskmanager-mcp/-/taskmanager-mcp-1.3.0.tgz","fileCount":17,"unpackedSize":72669,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQD22J3Zd4/k6c90AnnqjE11QyF+F7AH/uzaOy+KXtHyrwIgFSOKgCI9IC/KxNtlQQgWi5SnXYbF6MJvS3dvPu6ZWJM="}]},"_npmUser":{"name":"ryze_23x","email":"andres.guaglianone.ainovix@gmail.com"},"directories":{},"maintainers":[{"name":"ryze_23x","email":"andres.guaglianone.ainovix@gmail.com"},{"name":"johnlee1501","email":"jhonjhad@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/taskmanager-mcp_1.3.0_1786757597220_0.7959703427747482"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-26T19:12:09.436Z","modified":"2026-08-15T01:33:17.504Z","1.0.0":"2026-06-26T19:12:09.794Z","1.1.0":"2026-07-28T15:06:57.778Z","1.1.1":"2026-07-30T14:04:10.815Z","1.2.0":"2026-07-30T22:51:26.959Z","1.3.0":"2026-08-15T01:33:17.362Z"},"bugs":{"url":"https://github.com/ainovix/taskmanager/issues"},"author":{"name":"AINOVIX"},"license":"MIT","homepage":"https://github.com/ainovix/taskmanager#readme","keywords":["mcp","taskmanager","ai","model-context-protocol","task-management"],"repository":{"type":"git","url":"git+https://github.com/ainovix/taskmanager.git","directory":"packages/mcp-server"},"description":"MCP server for TaskManager — exposes task management as AI-consumable tools","maintainers":[{"name":"ryze_23x","email":"andres.guaglianone.ainovix@gmail.com"},{"name":"johnlee1501","email":"jhonjhad@gmail.com"}],"readme":"# @ainovix/taskmanager-mcp\r\n\r\nMCP server for [TaskManager](https://taskmanager.ainovix.com) — exposes task management as AI-consumable tools over the [Model Context Protocol](https://modelcontextprotocol.io).\r\n\r\n## What is this?\r\n\r\nThis package lets AI assistants (OpenCode, Claude Desktop, Cursor, etc.) interact with TaskManager through natural language. It connects to the TaskManager REST API and exposes 18 tools that AI models can call to list, create, update, and manage tasks.\r\n\r\n## Installation\r\n\r\nNo installation needed. Run directly via npx:\r\n\r\n```bash\r\nnpx -y @ainovix/taskmanager-mcp\r\n```\r\n\r\nRequires **Node.js 18+**.\r\n\r\n## Configuration\r\n\r\nSet the following environment variables:\r\n\r\n| Variable | Required | Default | Description |\r\n|----------|----------|---------|-------------|\r\n| `TASKMANAGER_API_KEY` | Yes | — | API key from TaskManager (Settings > API Keys) |\r\n| `TASKMANAGER_API_URL` | Yes | — | Base URL for your TaskManager instance (e.g. `https://your-domain.com`) |\r\n\r\n### Generate an API Key\r\n\r\n1. Log in to TaskManager\r\n2. Go to **Settings > API Keys** (admin) or **Profile > API Keys** (all roles)\r\n3. Click **Generate New Key**, copy the key immediately (shown only once)\r\n\r\n## Available Tools\r\n\r\n| Tool | Description |\r\n|------|-------------|\r\n| `auth_validate` | Validate the API key and return the current user's identity |\r\n| `list_tasks` | List tasks visible to the authenticated user (supports pagination and status filter) |\r\n| `get_task` | Get a single task by its ID |\r\n| `create_task` | Create a new task (requires title and area_id) |\r\n| `update_task` | Update task fields (title, description, assigned_to, due_date) |\r\n| `update_task_status` | Change task status (`open`, `in-progress`, `completed`, `accepted`, `rejected`) |\r\n| `delete_task` | Soft-delete a task (admin and manager roles only) |\r\n| `add_comment` | Add a comment to a task (types: `comment`, `observation`, `blocker`) |\r\n| `list_comments` | List all comments on a task |\r\n| `list_activities` | List activity history for a task |\r\n| `get_dashboard_stats` | Get task count statistics (by status, overdue, etc.) |\r\n| `add_subtask` | Add a subtask to a task |\r\n| `update_subtask` | Update a subtask's title or description |\r\n| `toggle_subtask` | Mark a subtask as completed or incomplete |\r\n| `delete_subtask` | Delete a subtask |\r\n| `list_areas` | List all organizational areas |\r\n| `list_users` | List all users (admin and manager roles only) |\r\n| `list_priorities` | List all priority levels |\r\n\r\n## MCP Client Configuration\r\n\r\n### OpenCode (`opencode.jsonc`)\r\n\r\n```jsonc\r\n{\r\n  \"mcp\": {\r\n    \"taskmanager\": {\r\n      \"type\": \"local\",\r\n      \"command\": [\"npx\", \"-y\", \"@ainovix/taskmanager-mcp\"],\r\n      \"enabled\": true,\r\n      \"environment\": {\r\n        \"TASKMANAGER_API_KEY\": \"{env:TASKMANAGER_API_KEY}\",\r\n        \"TASKMANAGER_API_URL\": \"{env:TASKMANAGER_API_URL}\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Claude Desktop (`claude_desktop_config.json`)\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"taskmanager\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@ainovix/taskmanager-mcp\"],\r\n      \"env\": {\r\n        \"TASKMANAGER_API_KEY\": \"tmk_live_your_key_here\",\r\n        \"TASKMANAGER_API_URL\": \"https://your-taskmanager-instance.com\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## Development\r\n\r\n```bash\r\n# Install dependencies\r\npnpm install\r\n\r\n# Build\r\npnpm build\r\n\r\n# Run tests\r\npnpm test\r\n\r\n# Run locally (requires TASKMANAGER_API_KEY)\r\nTASKMANAGER_API_KEY=tmk_live_... pnpm start\r\n```\r\n\r\n### Project Structure\r\n\r\n```\r\npackages/mcp-server/\r\n  src/\r\n    index.ts       — Entry point (stdio transport)\r\n    server.ts      — MCP server with 18 tool registrations\r\n    client.ts      — HTTP client for TaskManager REST API\r\n    config.ts      — Environment variable loading and validation\r\n    errors.ts      — Error types (McpHttpError, ConfigError)\r\n  tests/\r\n    config.test.ts — Config validation tests\r\n    client.test.ts — HTTP client tests (mocked fetch)\r\n    server.test.ts — Tool registration tests\r\n```\r\n\r\n### Publishing\r\n\r\n```bash\r\npnpm build\r\nnpm publish --access public\r\n```\r\n\r\n## Why TypeScript instead of Python?\r\n\r\nThe original MCP design specified a Python implementation. We deliberately chose TypeScript (Node.js) for these reasons:\r\n\r\n- **Ecosystem parity**: The TaskManager frontend is a Next.js app — the team's primary stack is TypeScript. A Node.js MCP server means zero context-switching and shared tooling.\r\n- **Zero-install via npx**: Publishing to npm lets users run `npx -y @ainovix/taskmanager-mcp` without installing Python, managing virtualenvs, or dealing with pip dependencies.\r\n- **Shared team skills**: Every team member can read, review, and contribute to the MCP server without learning Python.\r\n- **Same protocol, same behavior**: The MCP protocol is transport-agnostic. The TypeScript implementation exposes identical tools and follows the same schema — the client experience is unchanged.\r\n\r\n## License\r\n\r\nMIT\r\n","readmeFilename":"README.md"}