Todoist API integration with managed OAuth. Manage tasks, projects, sections, labels, and comments. Use this skill when users want to create, update, complet...
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Access the Todoist API v1 with managed OAuth authentication. Manage tasks, projects, sections, labels, and comments.
# List all tasks python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/todoist/api/v1/tasks') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
https://gateway.maton.ai/todoist/api/v1/{resource}
The gateway proxies requests to
api.todoist.com/api/v1All requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEY
Environment Variable: Set your API key as
MATON_API_KEYexport MATON_API_KEY="YOUR_API_KEY"
Manage your Todoist OAuth connections at
https://ctrl.maton.aipython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=todoist&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'todoist'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
Response:
{ "connection": { "connection_id": "21fd90f9-5935-43cd-b6c8-bde9d915ca80", "status": "ACTIVE", "creation_time": "2025-12-08T07:20:53.488460Z", "last_updated_time": "2026-01-31T20:03:32.593153Z", "url": "https://connect.maton.ai/?session_token=...", "app": "todoist", "metadata": {} } }
Open the returned
urlpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If you have multiple Todoist connections, specify which one to use with the
Maton-Connectionpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/todoist/api/v1/tasks') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', '21fd90f9-5935-43cd-b6c8-bde9d915ca80') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If omitted, the gateway uses the default (oldest) active connection.
GET /todoist/api/v1/projects
Response:
{ "results": [ { "id": "6fwFRqmVCFvWVX5R", "name": "Inbox", "color": "charcoal", "parent_id": null, "child_order": 0, "is_shared": false, "is_favorite": false, "inbox_project": true, "view_style": "list", "description": "", "is_archived": false } ], "next_cursor": null }
GET /todoist/api/v1/projects/{id}
POST /todoist/api/v1/projects Content-Type: application/json{ "name": "My Project", "color": "blue", "is_favorite": true, "view_style": "board" }
Parameters:
nameparent_idcoloris_favoriteview_styleExample:
python <<'EOF' import urllib.request, os, json data = json.dumps({'name': 'My New Project', 'color': 'blue'}).encode() req = urllib.request.Request('https://gateway.maton.ai/todoist/api/v1/projects', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
POST /todoist/api/v1/projects/{id} Content-Type: application/json{ "name": "Updated Project Name", "color": "red" }
DELETE /todoist/api/v1/projects/{id}
Returns 204 No Content on success.
GET /todoist/api/v1/projects/{id}/collaborators
GET /todoist/api/v1/tasks
Query Parameters:
| Parameter | Type | Description |
|---|---|---|
| string | Filter by project |
| string | Filter by section |
| string | Filter by label name |
| string | Todoist filter expression |
| string | Comma-separated task IDs |
Response:
{ "results": [ { "id": "6fwhG9wMHr4wxgpR", "content": "Buy groceries", "description": "", "project_id": "6fwFRqmVCFvWVX5R", "section_id": null, "parent_id": null, "child_order": 1, "priority": 2, "checked": false, "labels": [], "due": { "date": "2026-02-07T10:00:00", "string": "tomorrow at 10am", "lang": "en", "is_recurring": false }, "added_at": "2026-02-06T20:41:08.449320Z" } ], "next_cursor": null }
GET /todoist/api/v1/tasks/{id}
POST /todoist/api/v1/tasks Content-Type: application/json{ "content": "Buy groceries", "project_id": "2366834771", "priority": 2, "due_string": "tomorrow at 10am", "labels": ["shopping", "errands"] }
Required Fields:
contentOptional Fields:
descriptionproject_idsection_idparent_idlabelsprioritydue_stringdue_datedue_datetimeassignee_iddurationduration_unitExample:
python <<'EOF' import urllib.request, os, json data = json.dumps({ 'content': 'Complete project report', 'priority': 4, 'due_string': 'tomorrow at 5pm', 'labels': ['work', 'urgent'] }).encode() req = urllib.request.Request('https://gateway.maton.ai/todoist/api/v1/tasks', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
POST /todoist/api/v1/tasks/{id} Content-Type: application/json{ "content": "Updated task content", "priority": 3 }
POST /todoist/api/v1/tasks/{id}/close
Returns 204 No Content. For recurring tasks, this schedules the next occurrence.
POST /todoist/api/v1/tasks/{id}/reopen
Returns 204 No Content.
DELETE /todoist/api/v1/tasks/{id}
Returns 204 No Content.
GET /todoist/api/v1/sections GET /todoist/api/v1/sections?project_id={project_id}
Response:
{ "results": [ { "id": "6g424m6CQm47v7mm", "project_id": "6g424jv8X52hP7qF", "section_order": 1, "name": "To Do", "added_at": "2026-02-20T22:25:04.203675Z", "is_archived": false, "is_collapsed": false } ], "next_cursor": null }
GET /todoist/api/v1/sections/{id}
POST /todoist/api/v1/sections Content-Type: application/json{ "name": "In Progress", "project_id": "2366834771", "order": 2 }
Required Fields:
nameproject_idPOST /todoist/api/v1/sections/{id} Content-Type: application/json{ "name": "Updated Section Name" }
DELETE /todoist/api/v1/sections/{id}
Returns 204 No Content.
GET /todoist/api/v1/labels
Response:
{ "results": [ { "id": "2182980313", "name": "urgent", "color": "red", "order": 1, "is_favorite": false } ], "next_cursor": null }
GET /todoist/api/v1/labels/{id}
POST /todoist/api/v1/labels Content-Type: application/json{ "name": "work", "color": "blue", "is_favorite": true }
Parameters:
namecolororderis_favoritePOST /todoist/api/v1/labels/{id} Content-Type: application/json{ "name": "updated-label", "color": "green" }
DELETE /todoist/api/v1/labels/{id}
Returns 204 No Content.
GET /todoist/api/v1/comments?task_id={task_id} GET /todoist/api/v1/comments?project_id={project_id}
Note: Either
task_idproject_idResponse:
{ "results": [ { "id": "6g424pWVXPpwW7hR", "item_id": "6g424pQr2xfCcFr2", "content": "This is a comment", "posted_at": "2026-02-20T22:25:20.045703Z", "posted_uid": "57402826", "file_attachment": null, "reactions": null } ], "next_cursor": null }
GET /todoist/api/v1/comments/{id}
POST /todoist/api/v1/comments Content-Type: application/json{ "task_id": "9993408170", "content": "Don't forget to check the budget" }
Required Fields:
contenttask_idproject_idPOST /todoist/api/v1/comments/{id} Content-Type: application/json{ "content": "Updated comment text" }
DELETE /todoist/api/v1/comments/{id}
Returns 204 No Content.
| Priority | Meaning |
|---|---|
| 1 | Normal (default) |
| 2 | Medium |
| 3 | High |
| 4 | Urgent |
Use ONE of these formats per request:
due_stringdue_datedue_datetime// Create a task const response = await fetch('https://gateway.maton.ai/todoist/api/v1/tasks', { method: 'POST', headers: { 'Authorization': `Bearer ${process.env.MATON_API_KEY}`, 'Content-Type': 'application/json' }, body: JSON.stringify({ content: 'Review pull request', priority: 3, due_string: 'today at 5pm' }) }); const task = await response.json();
import os import requestsCreate a task
response = requests.post( 'https://gateway.maton.ai/todoist/api/v1/tasks', headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'}, json={ 'content': 'Review pull request', 'priority': 3, 'due_string': 'today at 5pm' } ) task = response.json()
jq$MATON_API_KEY| Status | Meaning |
|---|---|
| 204 | Success (no content) - for close, reopen, delete operations |
| 400 | Invalid request or missing Todoist connection |
| 401 | Invalid or missing Maton API key |
| 404 | Resource not found |
| 429 | Rate limited |
| 4xx/5xx | Passthrough error from Todoist API |
MATON_API_KEYecho $MATON_API_KEY
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
todoisthttps://gateway.maton.ai/todoist/api/v1/taskshttps://gateway.maton.ai/api/v1/tasksNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.