todoist -cf

This MCP server provides a Cloudflare-hosted facility to interact with Todoist through an OAuth-based authorization flow. It currently exposes a single MCP tool that enables basic Todoist interactions on your Todoist account (e.g., listing tasks and creating/updating tasks via the authenticated session). Access to OAuth credentials is managed through Todoist app credentials, and the server is deployed as a Cloudflare Worker, making it accessible via the provided sse endpoint. To try it out, point your MCP client (such as the MCP Inspector or Cloudflare AI Playground) at the server URL and authorize the Todoist app when prompted. The workflow leverages OAuth tokens scoped for Todoist API access, ensuring that your data remains protected and only actions you authorize are performed.

Prerequisites:

• Node.js and npm installed on your machine
• Wrangler CLI (for Cloudflare Worker deployment) installed or available via npm
• A Todoist developer account to create an OAuth app
• Access to the repository’s deployment process (as described in the README)

Setup steps:

1. Create a Todoist OAuth app to obtain a client ID and client secret.
   • Go to Todoist Developer Console and create a new app.
   • Note down TODOIST_CLIENT_ID and TODOIST_CLIENT_SECRET.
2. Install dependencies and prepare the project:
   • Ensure you have wrangler configured (wrangler login, etc.).
   • Run: npm install
3. Configure secrets for Cloudflare Worker:
   • Use wrangler to set the OAuth credentials, for example: wrangler secret put TODOIST_CLIENT_ID wrangler secret put TODOIST_CLIENT_SECRET
4. Update wrangler configuration if needed (wrangler.jsonc as referenced in the README) with any required parameters for your deployment.
5. Deploy the Cloudflare Worker:
   • Run: npm run deploy
6. Verify deployment by opening the deployed URL (the MCP server endpoint) and authorizing Todoist access when prompted.

Notes and tips:

• The server uses OAuth-based authorization with Todoist, so you must register an OAuth app in Todoist and provide the client ID/secret as secrets to the deployment environment.
• Ensure you keep your OAuth credentials confidential and rotate them if needed.
• If you encounter authorization errors, re-check the Todoist app's redirect URIs and scopes to ensure they match what the MCP server expects.
• The endpoint to interact with the MCP server is usually exposed via the Cloudflare Workers URL (as shown in the README).
• If you need to update configuration, modify wrangler.jsonc and redeploy with npm run deploy.
• When testing locally, you may proxy to the Cloudflare Worker or use the MCP Inspector to verify tool behavior and data flow.