{"_id":"todoist-mcp-enhanced-server","name":"todoist-mcp-enhanced-server","dist-tags":{"latest":"0.1.4"},"versions":{"0.1.4":{"name":"todoist-mcp-enhanced-server","version":"0.1.4","description":"MCP server for Todoist API integration","main":"dist/index.js","types":"dist/index.d.ts","type":"module","bin":{"mcp-server-todoist":"dist/index.js"},"scripts":{"build":"tsc && shx chmod +x dist/*.js","prepare":"npm run build","watch":"tsc --watch"},"repository":{"type":"git","url":"git+https://github.com/lotarcc/todoist-mcp-server.git"},"keywords":["mcp","todoist","claude","ai","task-management","project-management","modelcontextprotocol"],"author":{"name":"lotarcc"},"license":"MIT","bugs":{"url":"https://github.com/lotarcc/todoist-mcp-server/issues"},"homepage":"https://github.com/lotarcc/todoist-mcp-server#readme","dependencies":{"@doist/todoist-api-typescript":"^3.0.3","@modelcontextprotocol/sdk":"^0.5.0"},"devDependencies":{"@types/node":"^22.10.2","shx":"^0.3.4","typescript":"^5.7.2"},"_id":"todoist-mcp-enhanced-server@0.1.4","gitHead":"0fd454b71b6c3b824475ba7fe502656bf70e45f7","_nodeVersion":"22.9.0","_npmVersion":"10.8.3","dist":{"integrity":"sha512-rHYTT7CwkBtsVXK0iy0RMn83dRDZd5n9wKJxmIDMqp/Kwm4ZuaVKa7euVmoCtVaVTr0taeujTJj+NhCxweftYA==","shasum":"54df21011de177e46130ab90a1c125d0799cd787","tarball":"https://registry.npmjs.org/todoist-mcp-enhanced-server/-/todoist-mcp-enhanced-server-0.1.4.tgz","fileCount":5,"unpackedSize":29897,"signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCmVbu6T9SQV/BxQRQOl7ANHzOR5VOL3gphcVHrayQkDgIgVO6Wu1OpaXFquxZuPaJo2BigpDy2+cme+w3JwUYf0og="}]},"_npmUser":{"name":"lotarc","email":"semyon.kolesnikov@outlook.com"},"directories":{},"maintainers":[{"name":"lotarc","email":"semyon.kolesnikov@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/todoist-mcp-enhanced-server_0.1.4_1734129820559_0.6136931251028686"},"_hasShrinkwrap":false}},"time":{"created":"2024-12-13T22:43:40.558Z","0.1.4":"2024-12-13T22:43:40.739Z","modified":"2024-12-13T22:43:40.980Z"},"maintainers":[{"name":"lotarc","email":"semyon.kolesnikov@outlook.com"}],"description":"MCP server for Todoist API integration","homepage":"https://github.com/lotarcc/todoist-mcp-server#readme","keywords":["mcp","todoist","claude","ai","task-management","project-management","modelcontextprotocol"],"repository":{"type":"git","url":"git+https://github.com/lotarcc/todoist-mcp-server.git"},"author":{"name":"lotarcc"},"bugs":{"url":"https://github.com/lotarcc/todoist-mcp-server/issues"},"license":"MIT","readme":"# Todoist MCP Server\n\nAn MCP (Model Context Protocol) server implementation that integrates Claude with Todoist, enabling natural language task management. This server allows Claude to interact with your Todoist tasks, projects, and sections using everyday language.\n\n## Features\n\n* **Project Management**: Create, update, and manage Todoist projects\n* **Section Organization**: Create and manage sections within projects\n* **Natural Language Task Management**: Create, update, complete, and delete tasks using everyday language\n* **Smart Task Search**: Find tasks using partial name matches\n* **Flexible Filtering**: Filter tasks by project, section, due date, priority, and other attributes\n* **Rich Task Details**: Support for descriptions, due dates, priority levels, and project/section assignment\n* **Intuitive Error Handling**: Clear feedback for better user experience\n\n## Installation\n\n```bash\nnpm install -g todoist-mcp-enhanced-server\n```\n\n## Tools\n\n### Project Management\n\n#### todoist_get_projects\nGet a list of all projects:\n* Lists all projects with their IDs and attributes\n* Example: \"Show all my projects\"\n\n#### todoist_create_project\nCreate new projects:\n* Required: name\n* Optional: parent_id (for nested projects), color, favorite status\n* Example: \"Create project 'Work Tasks' with color blue\"\n\n#### todoist_update_project\nUpdate existing projects:\n* Required: project_id\n* Optional: name, color, favorite status\n* Example: \"Update project 'Work Tasks' to be a favorite\"\n\n### Section Management\n\n#### todoist_get_project_sections\nGet sections within a project:\n* Required: project_id\n* Lists all sections in the specified project\n* Example: \"Show sections in project 'Work Tasks'\"\n\n#### todoist_create_section\nCreate new sections:\n* Required: project_id, name\n* Optional: order\n* Example: \"Create section 'In Progress' in project 'Work Tasks'\"\n\n### Task Management\n\n#### todoist_create_task\nCreate new tasks with various attributes:\n* Required: content (task title)\n* Optional: description, due date, priority level (1-4), project_id, section_id\n* Example: \"Create task 'Team Meeting' in project 'Work' section 'Planning'\"\n\n#### todoist_get_tasks\nRetrieve and filter tasks:\n* Filter by project, section, due date, priority\n* Natural language date filtering\n* Optional result limit\n* Example: \"Show high priority tasks in project 'Work' due this week\"\n\n#### todoist_update_task\nUpdate existing tasks using natural language search:\n* Find tasks by partial name match\n* Update any task attribute (content, description, due date, priority, project, section)\n* Example: \"Move meeting task to project 'Work' section 'In Progress'\"\n\n#### todoist_move_task\nMove tasks between projects and sections:\n* Find tasks by name\n* Optional: project_id, section_id\n* Example: \"Move task 'Documentation' to section 'Done'\"\n\n#### todoist_complete_task\nMark tasks as complete using natural language search:\n* Find tasks by partial name match\n* Confirm completion status\n* Example: \"Mark the documentation task as complete\"\n\n#### todoist_delete_task\nRemove tasks using natural language search:\n* Find and delete tasks by name\n* Confirmation messages\n* Example: \"Delete the PR review task\"\n\n## Setup\n\n### Getting a Todoist API Token\n1. Log in to your Todoist account\n2. Navigate to Settings → Integrations\n3. Find your API token under \"Developer\"\n\n### Usage with Cline\n\nAdd to your Cline MCP settings file:\n\n```json\n{\n  \"mcpServers\": {\n    \"todoist\": {\n      \"command\": \"npx\",\n      \"args\": [\"todoist-mcp-enhanced-server\"],\n      \"env\": {\n        \"TODOIST_API_TOKEN\": \"your_api_token_here\"\n      }\n    }\n  }\n}\n```\n\n## Example Usage\n\n### Project Management\n```\n\"Show all my projects\"\n\"Create project 'Work Tasks'\"\n\"Update project color to blue\"\n```\n\n### Section Management\n```\n\"Show sections in project 'Work'\"\n\"Create section 'In Progress' in project 'Work'\"\n```\n\n### Task Management\n```\n\"Create task 'Review PR' in project 'Work' section 'To Do'\"\n\"Move task 'Documentation' to section 'In Progress'\"\n\"Show tasks in project 'Work' section 'Done'\"\n\"Update meeting task priority to high and move to 'Planning' section\"\n```\n\n## Development\n\n### Building from source\n```bash\n# Clone the repository\ngit clone https://github.com/lotarcc/todoist-mcp-server.git\n\n# Navigate to directory\ncd todoist-mcp-server\n\n# Install dependencies\nnpm install\n\n# Build the project\nnpm run build\n```\n\n## Contributing\nContributions are welcome! Feel free to submit a Pull Request.\n\n## License\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Issues and Support\nIf you encounter any issues or need support, please file an issue on the [GitHub repository](https://github.com/lotarcc/todoist-mcp-server/issues).\n","readmeFilename":"README.md"}