Skip to content

Cursor plugin specification and official plugins

TypeScript

Add Todoist third-party MCP plugin

Cursor Agentd47646366a83
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index 77f4e02a..ad65a9e6 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -237,6 +237,11 @@
"name": "mercury",
"source": "third_party/mercury",
"description": "Read balances, transactions, statements, and cards."
+ },
+ {
+ "name": "todoist",
+ "source": "third_party/todoist",
+ "description": "Create, find, and complete tasks and projects."
}
]
}
diff --git a/README.md b/README.md
index 2a1152ee..ed04e91b 100644
--- a/README.md
+++ b/README.md
@@ -52,6 +52,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| `workable` | [Workable](third_party/workable/) | Cursor | Integrations | Search candidates, move pipelines, and manage HR records. |
| `brex` | [Brex](third_party/brex/) | Cursor | Integrations | Query expenses, receipts, bills, cards, and travel. |
| `mercury` | [Mercury](third_party/mercury/) | Cursor | Integrations | Read balances, transactions, statements, and cards. |
+| `todoist` | [Todoist](third_party/todoist/) | Cursor | Integrations | Create, find, and complete tasks and projects. |
Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).
## Repository structure
diff --git a/third_party/todoist/.cursor-plugin/plugin.json b/third_party/todoist/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..0a7fbe20
--- /dev/null
+++ b/third_party/todoist/.cursor-plugin/plugin.json
@@ -0,0 +1,33 @@
+{
+ "name": "todoist",
+ "displayName": "Todoist",
+ "version": "1.0.0",
+ "minClientVersions": {
+ "cursor": "3.13.0"
+ },
+ "description": "Create, find, and complete tasks and projects.",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://github.com/Doist/todoist-mcp",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "logo": "assets/logo.png",
+ "keywords": [
+ "todoist",
+ "tasks",
+ "todo",
+ "projects",
+ "productivity",
+ "mcp"
+ ],
+ "category": "integrations",
+ "tags": [
+ "todoist",
+ "tasks",
+ "mcp",
+ "productivity"
+ ],
+ "mcpServers": "./mcp.json"
+}
diff --git a/third_party/todoist/CHANGELOG.md b/third_party/todoist/CHANGELOG.md
new file mode 100644
index 00000000..d8d22562
--- /dev/null
+++ b/third_party/todoist/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Added the `todoist` MCP server pointing at `https://ai.todoist.net/mcp`.
+- Auth uses OAuth — no API key or client ID to configure.
+- Logo: Todoist's official mark, from the `Doist` GitHub organization.
diff --git a/third_party/todoist/LICENSE b/third_party/todoist/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/third_party/todoist/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cursor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/third_party/todoist/README.md b/third_party/todoist/README.md
new file mode 100644
index 00000000..f1a62ce8
--- /dev/null
+++ b/third_party/todoist/README.md
@@ -0,0 +1,57 @@
+# Todoist
+
+Cursor plugin that connects agents to [Todoist](https://www.todoist.com) through Todoist's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.
+
+Create, find, update, and complete tasks, and manage projects, sections, labels, and due dates in the signed-in Todoist account.
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **Todoist**.
+3. Click **Install**, then complete the Todoist sign-in prompt.
+
+Or run `/add-plugin todoist` in chat.
+
+## MCP
+
+```json
+{
+ "mcpServers": {
+ "todoist": {
+ "type": "http",
+ "url": "https://ai.todoist.net/mcp"
+ }
+ }
+}
+```
+
+Auth is OAuth. Cursor prompts for Todoist sign-in on the first tool call — there is no API key to configure.
+
+## What agents can do
+
+| Category | Capabilities |
+| --- | --- |
+| Tasks | Create, update, complete, and reopen tasks, including due dates and reminders |
+| Projects | Manage projects, sections, and labels |
+| Search | `search` and `fetch` tools for finding tasks and pulling their details |
+| Comments | Read and add comments on tasks and projects |
+
+The hosted runtime is the source of truth for tool names and schemas.
+
+## Notes
+
+- Tool calls run as the Todoist user who authorizes the connection.
+- Doist also publishes an official local server, `@doist/todoist-mcp`, which authenticates with a `TODOIST_API_KEY`. It is worth switching to if you hit session disconnections on the hosted endpoint.
+- No Todoist plan tier is required. The paid-plan requirements in Todoist's help articles apply to the AI client, not to Todoist.
+
+## Docs
+
+- Todoist MCP server: https://github.com/Doist/todoist-mcp
+- Use Todoist MCP: https://www.todoist.com/help/articles/use-chatgpt-with-todoist-mcp-WEeLx9d8h
+- Server URL: https://ai.todoist.net/mcp
+
+Logo is Todoist's official mark, from the `Doist` GitHub organization.
+
+## License
+
+MIT
diff --git a/third_party/todoist/assets/logo.png b/third_party/todoist/assets/logo.png
new file mode 100644
index 00000000..c37533e5
Binary files /dev/null and b/third_party/todoist/assets/logo.png differ
diff --git a/third_party/todoist/mcp.json b/third_party/todoist/mcp.json
new file mode 100644
index 00000000..1aae3048
--- /dev/null
+++ b/third_party/todoist/mcp.json
@@ -0,0 +1,8 @@
+{
+ "mcpServers": {
+ "todoist": {
+ "type": "http",
+ "url": "https://ai.todoist.net/mcp"
+ }
+ }
+}