@doist/todoist-ai 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (259) hide show
  1. package/README.md +1 -1
  2. package/dist/cjs/index.d.ts +477 -0
  3. package/dist/cjs/index.d.ts.map +1 -0
  4. package/dist/cjs/index.js +49 -0
  5. package/dist/cjs/main.d.ts.map +1 -0
  6. package/dist/cjs/mcp-helpers.d.ts.map +1 -0
  7. package/dist/cjs/mcp-server.d.ts.map +1 -0
  8. package/dist/cjs/todoist-tool.d.ts.map +1 -0
  9. package/dist/cjs/tools/account-overview.d.ts.map +1 -0
  10. package/dist/cjs/tools/project-overview.d.ts.map +1 -0
  11. package/dist/cjs/tools/projects-add-one.d.ts.map +1 -0
  12. package/dist/cjs/tools/projects-delete-one.d.ts.map +1 -0
  13. package/dist/cjs/tools/projects-list.d.ts.map +1 -0
  14. package/dist/cjs/tools/projects-search.d.ts.map +1 -0
  15. package/dist/cjs/tools/projects-update-one.d.ts.map +1 -0
  16. package/dist/cjs/tools/sections-add-one.d.ts.map +1 -0
  17. package/dist/cjs/tools/sections-delete-one.d.ts.map +1 -0
  18. package/dist/cjs/tools/sections-search.d.ts.map +1 -0
  19. package/dist/cjs/tools/sections-update-one.d.ts.map +1 -0
  20. package/dist/cjs/tools/shared.d.ts.map +1 -0
  21. package/dist/cjs/tools/subtasks-list-for-parent-task.d.ts.map +1 -0
  22. package/dist/cjs/tools/tasks-add-multiple.d.ts.map +1 -0
  23. package/dist/cjs/tools/tasks-by-date-range.d.ts.map +1 -0
  24. package/dist/cjs/tools/tasks-by-project.d.ts.map +1 -0
  25. package/dist/cjs/tools/tasks-complete-multiple.d.ts.map +1 -0
  26. package/dist/cjs/tools/tasks-delete-one.d.ts.map +1 -0
  27. package/dist/cjs/tools/tasks-list-for-section.d.ts.map +1 -0
  28. package/dist/cjs/tools/tasks-list-overdue.d.ts.map +1 -0
  29. package/dist/cjs/tools/tasks-organize-multiple.d.ts.map +1 -0
  30. package/dist/cjs/tools/tasks-search.d.ts.map +1 -0
  31. package/dist/cjs/tools/tasks-update-one.d.ts.map +1 -0
  32. package/dist/esm/index.d.ts +477 -0
  33. package/dist/esm/index.d.ts.map +1 -0
  34. package/dist/esm/index.js +49 -0
  35. package/dist/esm/main.d.ts +2 -0
  36. package/dist/esm/main.d.ts.map +1 -0
  37. package/dist/esm/main.js +23 -0
  38. package/dist/esm/mcp-helpers.d.ts +13 -0
  39. package/dist/esm/mcp-helpers.d.ts.map +1 -0
  40. package/dist/esm/mcp-helpers.js +52 -0
  41. package/dist/esm/mcp-server.d.ts +11 -0
  42. package/dist/esm/mcp-server.d.ts.map +1 -0
  43. package/{src/mcp-server.ts → dist/esm/mcp-server.js} +31 -44
  44. package/dist/esm/todoist-tool.d.ts +35 -0
  45. package/dist/esm/todoist-tool.d.ts.map +1 -0
  46. package/dist/esm/todoist-tool.js +1 -0
  47. package/dist/esm/tools/account-overview.d.ts +9 -0
  48. package/dist/esm/tools/account-overview.d.ts.map +1 -0
  49. package/dist/esm/tools/account-overview.js +94 -0
  50. package/dist/esm/tools/project-overview.d.ts +14 -0
  51. package/dist/esm/tools/project-overview.d.ts.map +1 -0
  52. package/dist/esm/tools/project-overview.js +107 -0
  53. package/dist/esm/tools/projects-add-one.d.ts +22 -0
  54. package/dist/esm/tools/projects-add-one.d.ts.map +1 -0
  55. package/dist/esm/tools/projects-add-one.js +15 -0
  56. package/dist/esm/tools/projects-delete-one.d.ts +15 -0
  57. package/dist/esm/tools/projects-delete-one.d.ts.map +1 -0
  58. package/dist/esm/tools/projects-delete-one.js +14 -0
  59. package/dist/esm/tools/projects-list.d.ts +18 -0
  60. package/dist/esm/tools/projects-list.d.ts.map +1 -0
  61. package/dist/esm/tools/projects-list.js +30 -0
  62. package/dist/esm/tools/projects-search.d.ts +29 -0
  63. package/dist/esm/tools/projects-search.d.ts.map +1 -0
  64. package/dist/esm/tools/projects-search.js +39 -0
  65. package/dist/esm/tools/projects-update-one.d.ts +15 -0
  66. package/dist/esm/tools/projects-update-one.d.ts.map +1 -0
  67. package/dist/esm/tools/projects-update-one.js +16 -0
  68. package/dist/esm/tools/sections-add-one.d.ts +15 -0
  69. package/dist/esm/tools/sections-add-one.d.ts.map +1 -0
  70. package/dist/esm/tools/sections-add-one.js +21 -0
  71. package/dist/esm/tools/sections-delete-one.d.ts +15 -0
  72. package/dist/esm/tools/sections-delete-one.d.ts.map +1 -0
  73. package/dist/esm/tools/sections-delete-one.js +14 -0
  74. package/dist/esm/tools/sections-search.d.ts +18 -0
  75. package/dist/esm/tools/sections-search.d.ts.map +1 -0
  76. package/dist/esm/tools/sections-search.js +30 -0
  77. package/dist/esm/tools/sections-update-one.d.ts +15 -0
  78. package/dist/esm/tools/sections-update-one.d.ts.map +1 -0
  79. package/dist/esm/tools/sections-update-one.js +16 -0
  80. package/dist/esm/tools/shared.d.ts +55 -0
  81. package/dist/esm/tools/shared.d.ts.map +1 -0
  82. package/dist/esm/tools/shared.js +71 -0
  83. package/dist/esm/tools/subtasks-list-for-parent-task.d.ts +31 -0
  84. package/dist/esm/tools/subtasks-list-for-parent-task.d.ts.map +1 -0
  85. package/dist/esm/tools/subtasks-list-for-parent-task.js +37 -0
  86. package/dist/esm/tools/tasks-add-multiple.d.ts +50 -0
  87. package/dist/esm/tools/tasks-add-multiple.d.ts.map +1 -0
  88. package/dist/esm/tools/tasks-add-multiple.js +47 -0
  89. package/dist/esm/tools/tasks-by-date-range.d.ts +33 -0
  90. package/dist/esm/tools/tasks-by-date-range.d.ts.map +1 -0
  91. package/dist/esm/tools/tasks-by-date-range.js +47 -0
  92. package/dist/esm/tools/tasks-by-project.d.ts +31 -0
  93. package/dist/esm/tools/tasks-by-project.d.ts.map +1 -0
  94. package/dist/esm/tools/tasks-by-project.js +37 -0
  95. package/dist/esm/tools/tasks-complete-multiple.d.ts +16 -0
  96. package/dist/esm/tools/tasks-complete-multiple.d.ts.map +1 -0
  97. package/dist/esm/tools/tasks-complete-multiple.js +26 -0
  98. package/dist/esm/tools/tasks-delete-one.d.ts +15 -0
  99. package/dist/esm/tools/tasks-delete-one.d.ts.map +1 -0
  100. package/dist/esm/tools/tasks-delete-one.js +14 -0
  101. package/dist/esm/tools/tasks-list-for-section.d.ts +31 -0
  102. package/dist/esm/tools/tasks-list-for-section.d.ts.map +1 -0
  103. package/dist/esm/tools/tasks-list-for-section.js +37 -0
  104. package/dist/esm/tools/tasks-list-overdue.d.ts +29 -0
  105. package/dist/esm/tools/tasks-list-overdue.d.ts.map +1 -0
  106. package/dist/esm/tools/tasks-list-overdue.js +29 -0
  107. package/dist/esm/tools/tasks-organize-multiple.d.ts +37 -0
  108. package/dist/esm/tools/tasks-organize-multiple.d.ts.map +1 -0
  109. package/dist/esm/tools/tasks-organize-multiple.js +40 -0
  110. package/dist/esm/tools/tasks-search.d.ts +31 -0
  111. package/dist/esm/tools/tasks-search.d.ts.map +1 -0
  112. package/dist/esm/tools/tasks-search.js +30 -0
  113. package/dist/esm/tools/tasks-update-one.d.ts +27 -0
  114. package/dist/esm/tools/tasks-update-one.d.ts.map +1 -0
  115. package/dist/esm/tools/tasks-update-one.js +42 -0
  116. package/dist/types/index.d.ts +476 -0
  117. package/dist/types/main.d.ts +1 -0
  118. package/dist/types/mcp-helpers.d.ts +12 -0
  119. package/dist/types/mcp-server.d.ts +10 -0
  120. package/dist/types/todoist-tool.d.ts +34 -0
  121. package/dist/types/tools/account-overview.d.ts +8 -0
  122. package/dist/types/tools/project-overview.d.ts +13 -0
  123. package/dist/types/tools/projects-add-one.d.ts +21 -0
  124. package/dist/types/tools/projects-delete-one.d.ts +14 -0
  125. package/dist/types/tools/projects-list.d.ts +17 -0
  126. package/dist/types/tools/projects-search.d.ts +28 -0
  127. package/dist/types/tools/projects-update-one.d.ts +14 -0
  128. package/dist/types/tools/sections-add-one.d.ts +14 -0
  129. package/dist/types/tools/sections-delete-one.d.ts +14 -0
  130. package/dist/types/tools/sections-search.d.ts +17 -0
  131. package/dist/types/tools/sections-update-one.d.ts +14 -0
  132. package/dist/types/tools/shared.d.ts +54 -0
  133. package/dist/types/tools/subtasks-list-for-parent-task.d.ts +30 -0
  134. package/dist/types/tools/tasks-add-multiple.d.ts +49 -0
  135. package/dist/types/tools/tasks-by-date-range.d.ts +32 -0
  136. package/dist/types/tools/tasks-by-project.d.ts +30 -0
  137. package/dist/types/tools/tasks-complete-multiple.d.ts +15 -0
  138. package/dist/types/tools/tasks-delete-one.d.ts +14 -0
  139. package/dist/types/tools/tasks-list-for-section.d.ts +30 -0
  140. package/dist/types/tools/tasks-list-overdue.d.ts +28 -0
  141. package/dist/types/tools/tasks-organize-multiple.d.ts +36 -0
  142. package/dist/types/tools/tasks-search.d.ts +30 -0
  143. package/dist/types/tools/tasks-update-one.d.ts +26 -0
  144. package/package.json +20 -7
  145. package/dist/index.d.ts +0 -2
  146. package/dist/index.d.ts.map +0 -1
  147. package/dist/index.js +0 -1
  148. package/dist/main.d.ts.map +0 -1
  149. package/dist/mcp-helpers.d.ts.map +0 -1
  150. package/dist/mcp-server.d.ts.map +0 -1
  151. package/dist/todoist-tool.d.ts.map +0 -1
  152. package/dist/tools/account-overview.d.ts.map +0 -1
  153. package/dist/tools/index.d.ts +0 -23
  154. package/dist/tools/index.d.ts.map +0 -1
  155. package/dist/tools/index.js +0 -22
  156. package/dist/tools/project-overview.d.ts.map +0 -1
  157. package/dist/tools/projects-add-one.d.ts.map +0 -1
  158. package/dist/tools/projects-delete-one.d.ts.map +0 -1
  159. package/dist/tools/projects-list.d.ts.map +0 -1
  160. package/dist/tools/projects-search.d.ts.map +0 -1
  161. package/dist/tools/projects-update-one.d.ts.map +0 -1
  162. package/dist/tools/sections-add-one.d.ts.map +0 -1
  163. package/dist/tools/sections-delete-one.d.ts.map +0 -1
  164. package/dist/tools/sections-search.d.ts.map +0 -1
  165. package/dist/tools/sections-update-one.d.ts.map +0 -1
  166. package/dist/tools/shared.d.ts.map +0 -1
  167. package/dist/tools/subtasks-list-for-parent-task.d.ts.map +0 -1
  168. package/dist/tools/tasks-add-multiple.d.ts.map +0 -1
  169. package/dist/tools/tasks-by-date-range.d.ts.map +0 -1
  170. package/dist/tools/tasks-by-project.d.ts.map +0 -1
  171. package/dist/tools/tasks-complete-multiple.d.ts.map +0 -1
  172. package/dist/tools/tasks-delete-one.d.ts.map +0 -1
  173. package/dist/tools/tasks-list-for-section.d.ts.map +0 -1
  174. package/dist/tools/tasks-list-overdue.d.ts.map +0 -1
  175. package/dist/tools/tasks-organize-multiple.d.ts.map +0 -1
  176. package/dist/tools/tasks-search.d.ts.map +0 -1
  177. package/dist/tools/tasks-update-one.d.ts.map +0 -1
  178. package/src/index.ts +0 -1
  179. package/src/main.ts +0 -26
  180. package/src/mcp-helpers.ts +0 -76
  181. package/src/todoist-tool.ts +0 -42
  182. package/src/tools/account-overview.ts +0 -130
  183. package/src/tools/index.ts +0 -26
  184. package/src/tools/project-overview.ts +0 -130
  185. package/src/tools/projects-add-one.ts +0 -19
  186. package/src/tools/projects-delete-one.ts +0 -18
  187. package/src/tools/projects-list.ts +0 -36
  188. package/src/tools/projects-search.ts +0 -49
  189. package/src/tools/projects-update-one.ts +0 -20
  190. package/src/tools/sections-add-one.ts +0 -25
  191. package/src/tools/sections-delete-one.ts +0 -18
  192. package/src/tools/sections-search.ts +0 -39
  193. package/src/tools/sections-update-one.ts +0 -20
  194. package/src/tools/shared.ts +0 -94
  195. package/src/tools/subtasks-list-for-parent-task.ts +0 -43
  196. package/src/tools/tasks-add-multiple.ts +0 -53
  197. package/src/tools/tasks-by-date-range.ts +0 -58
  198. package/src/tools/tasks-by-project.ts +0 -43
  199. package/src/tools/tasks-complete-multiple.ts +0 -29
  200. package/src/tools/tasks-delete-one.ts +0 -18
  201. package/src/tools/tasks-list-for-section.ts +0 -43
  202. package/src/tools/tasks-list-overdue.ts +0 -35
  203. package/src/tools/tasks-organize-multiple.ts +0 -45
  204. package/src/tools/tasks-search.ts +0 -36
  205. package/src/tools/tasks-update-one.ts +0 -48
  206. /package/dist/{main.d.ts → cjs/main.d.ts} +0 -0
  207. /package/dist/{main.js → cjs/main.js} +0 -0
  208. /package/dist/{mcp-helpers.d.ts → cjs/mcp-helpers.d.ts} +0 -0
  209. /package/dist/{mcp-helpers.js → cjs/mcp-helpers.js} +0 -0
  210. /package/dist/{mcp-server.d.ts → cjs/mcp-server.d.ts} +0 -0
  211. /package/dist/{mcp-server.js → cjs/mcp-server.js} +0 -0
  212. /package/dist/{todoist-tool.d.ts → cjs/todoist-tool.d.ts} +0 -0
  213. /package/dist/{todoist-tool.js → cjs/todoist-tool.js} +0 -0
  214. /package/dist/{tools → cjs/tools}/account-overview.d.ts +0 -0
  215. /package/dist/{tools → cjs/tools}/account-overview.js +0 -0
  216. /package/dist/{tools → cjs/tools}/project-overview.d.ts +0 -0
  217. /package/dist/{tools → cjs/tools}/project-overview.js +0 -0
  218. /package/dist/{tools → cjs/tools}/projects-add-one.d.ts +0 -0
  219. /package/dist/{tools → cjs/tools}/projects-add-one.js +0 -0
  220. /package/dist/{tools → cjs/tools}/projects-delete-one.d.ts +0 -0
  221. /package/dist/{tools → cjs/tools}/projects-delete-one.js +0 -0
  222. /package/dist/{tools → cjs/tools}/projects-list.d.ts +0 -0
  223. /package/dist/{tools → cjs/tools}/projects-list.js +0 -0
  224. /package/dist/{tools → cjs/tools}/projects-search.d.ts +0 -0
  225. /package/dist/{tools → cjs/tools}/projects-search.js +0 -0
  226. /package/dist/{tools → cjs/tools}/projects-update-one.d.ts +0 -0
  227. /package/dist/{tools → cjs/tools}/projects-update-one.js +0 -0
  228. /package/dist/{tools → cjs/tools}/sections-add-one.d.ts +0 -0
  229. /package/dist/{tools → cjs/tools}/sections-add-one.js +0 -0
  230. /package/dist/{tools → cjs/tools}/sections-delete-one.d.ts +0 -0
  231. /package/dist/{tools → cjs/tools}/sections-delete-one.js +0 -0
  232. /package/dist/{tools → cjs/tools}/sections-search.d.ts +0 -0
  233. /package/dist/{tools → cjs/tools}/sections-search.js +0 -0
  234. /package/dist/{tools → cjs/tools}/sections-update-one.d.ts +0 -0
  235. /package/dist/{tools → cjs/tools}/sections-update-one.js +0 -0
  236. /package/dist/{tools → cjs/tools}/shared.d.ts +0 -0
  237. /package/dist/{tools → cjs/tools}/shared.js +0 -0
  238. /package/dist/{tools → cjs/tools}/subtasks-list-for-parent-task.d.ts +0 -0
  239. /package/dist/{tools → cjs/tools}/subtasks-list-for-parent-task.js +0 -0
  240. /package/dist/{tools → cjs/tools}/tasks-add-multiple.d.ts +0 -0
  241. /package/dist/{tools → cjs/tools}/tasks-add-multiple.js +0 -0
  242. /package/dist/{tools → cjs/tools}/tasks-by-date-range.d.ts +0 -0
  243. /package/dist/{tools → cjs/tools}/tasks-by-date-range.js +0 -0
  244. /package/dist/{tools → cjs/tools}/tasks-by-project.d.ts +0 -0
  245. /package/dist/{tools → cjs/tools}/tasks-by-project.js +0 -0
  246. /package/dist/{tools → cjs/tools}/tasks-complete-multiple.d.ts +0 -0
  247. /package/dist/{tools → cjs/tools}/tasks-complete-multiple.js +0 -0
  248. /package/dist/{tools → cjs/tools}/tasks-delete-one.d.ts +0 -0
  249. /package/dist/{tools → cjs/tools}/tasks-delete-one.js +0 -0
  250. /package/dist/{tools → cjs/tools}/tasks-list-for-section.d.ts +0 -0
  251. /package/dist/{tools → cjs/tools}/tasks-list-for-section.js +0 -0
  252. /package/dist/{tools → cjs/tools}/tasks-list-overdue.d.ts +0 -0
  253. /package/dist/{tools → cjs/tools}/tasks-list-overdue.js +0 -0
  254. /package/dist/{tools → cjs/tools}/tasks-organize-multiple.d.ts +0 -0
  255. /package/dist/{tools → cjs/tools}/tasks-organize-multiple.js +0 -0
  256. /package/dist/{tools → cjs/tools}/tasks-search.d.ts +0 -0
  257. /package/dist/{tools → cjs/tools}/tasks-search.js +0 -0
  258. /package/dist/{tools → cjs/tools}/tasks-update-one.d.ts +0 -0
  259. /package/dist/{tools → cjs/tools}/tasks-update-one.js +0 -0
@@ -1,20 +1,16 @@
1
1
  import { TodoistApi } from "@doist/todoist-api-typescript";
2
2
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
3
3
  import { registerTool } from "./mcp-helpers.js";
4
-
5
4
  import { projectsAddOne } from "./tools/projects-add-one.js";
6
5
  import { projectsDeleteOne } from "./tools/projects-delete-one.js";
7
6
  import { projectsList } from "./tools/projects-list.js";
8
7
  import { projectsSearch } from "./tools/projects-search.js";
9
8
  import { projectsUpdateOne } from "./tools/projects-update-one.js";
10
-
11
9
  import { sectionsAddOne } from "./tools/sections-add-one.js";
12
10
  import { sectionsDeleteOne } from "./tools/sections-delete-one.js";
13
11
  import { sectionsSearch } from "./tools/sections-search.js";
14
12
  import { sectionsUpdateOne } from "./tools/sections-update-one.js";
15
-
16
13
  import { subtasksListForParentTask } from "./tools/subtasks-list-for-parent-task.js";
17
-
18
14
  import { accountOverview } from "./tools/account-overview.js";
19
15
  import { projectOverview } from "./tools/project-overview.js";
20
16
  import { tasksAddMultiple } from "./tools/tasks-add-multiple.js";
@@ -27,53 +23,44 @@ import { tasksListOverdue } from "./tools/tasks-list-overdue.js";
27
23
  import { tasksOrganizeMultiple } from "./tools/tasks-organize-multiple.js";
28
24
  import { tasksSearch } from "./tools/tasks-search.js";
29
25
  import { tasksUpdateOne } from "./tools/tasks-update-one.js";
30
-
31
26
  const instructions = `
32
27
  Tools to help you manage your todoist tasks.
33
28
  `;
34
-
35
29
  /**
36
30
  * Create the MCP server.
37
31
  * @param todoistApiKey - The API key for the todoist account.
38
32
  * @returns the MCP server.
39
33
  */
40
- function getMcpServer({ todoistApiKey }: { todoistApiKey: string }) {
41
- const server = new McpServer(
42
- { name: "todoist-mcp-server", version: "0.1.0" },
43
- {
44
- capabilities: {
45
- tools: { listChanged: true },
46
- },
47
- instructions,
48
- },
49
- );
50
-
51
- const todoist = new TodoistApi(todoistApiKey);
52
-
53
- registerTool(tasksListByDate, server, todoist);
54
- registerTool(tasksListOverdue, server, todoist);
55
- registerTool(tasksListForProject, server, todoist);
56
- registerTool(tasksSearch, server, todoist);
57
- registerTool(projectsList, server, todoist);
58
- registerTool(tasksAddMultiple, server, todoist);
59
- registerTool(tasksUpdateOne, server, todoist);
60
- registerTool(tasksDeleteOne, server, todoist);
61
- registerTool(tasksCompleteMultiple, server, todoist);
62
- registerTool(projectsAddOne, server, todoist);
63
- registerTool(projectsUpdateOne, server, todoist);
64
- registerTool(sectionsAddOne, server, todoist);
65
- registerTool(sectionsUpdateOne, server, todoist);
66
- registerTool(tasksOrganizeMultiple, server, todoist);
67
- registerTool(subtasksListForParentTask, server, todoist);
68
- registerTool(tasksListForSection, server, todoist);
69
- registerTool(projectsDeleteOne, server, todoist);
70
- registerTool(projectsSearch, server, todoist);
71
- registerTool(sectionsDeleteOne, server, todoist);
72
- registerTool(sectionsSearch, server, todoist);
73
- registerTool(accountOverview, server, todoist);
74
- registerTool(projectOverview, server, todoist);
75
-
76
- return server;
34
+ function getMcpServer({ todoistApiKey }) {
35
+ const server = new McpServer({ name: "todoist-mcp-server", version: "0.1.0" }, {
36
+ capabilities: {
37
+ tools: { listChanged: true },
38
+ },
39
+ instructions,
40
+ });
41
+ const todoist = new TodoistApi(todoistApiKey);
42
+ registerTool(tasksListByDate, server, todoist);
43
+ registerTool(tasksListOverdue, server, todoist);
44
+ registerTool(tasksListForProject, server, todoist);
45
+ registerTool(tasksSearch, server, todoist);
46
+ registerTool(projectsList, server, todoist);
47
+ registerTool(tasksAddMultiple, server, todoist);
48
+ registerTool(tasksUpdateOne, server, todoist);
49
+ registerTool(tasksDeleteOne, server, todoist);
50
+ registerTool(tasksCompleteMultiple, server, todoist);
51
+ registerTool(projectsAddOne, server, todoist);
52
+ registerTool(projectsUpdateOne, server, todoist);
53
+ registerTool(sectionsAddOne, server, todoist);
54
+ registerTool(sectionsUpdateOne, server, todoist);
55
+ registerTool(tasksOrganizeMultiple, server, todoist);
56
+ registerTool(subtasksListForParentTask, server, todoist);
57
+ registerTool(tasksListForSection, server, todoist);
58
+ registerTool(projectsDeleteOne, server, todoist);
59
+ registerTool(projectsSearch, server, todoist);
60
+ registerTool(sectionsDeleteOne, server, todoist);
61
+ registerTool(sectionsSearch, server, todoist);
62
+ registerTool(accountOverview, server, todoist);
63
+ registerTool(projectOverview, server, todoist);
64
+ return server;
77
65
  }
78
-
79
66
  export { getMcpServer };
@@ -0,0 +1,35 @@
1
+ import type { TodoistApi } from "@doist/todoist-api-typescript";
2
+ import type { z } from "zod";
3
+ /**
4
+ * A Todoist tool that can be used in an MCP server or other conversational AI interfaces.
5
+ */
6
+ type TodoistTool<Params extends z.ZodRawShape> = {
7
+ /**
8
+ * The name of the tool.
9
+ */
10
+ name: string;
11
+ /**
12
+ * The description of the tool. This is important for the LLM to understand what the tool does,
13
+ * and how to use it.
14
+ */
15
+ description: string;
16
+ /**
17
+ * The schema of the parameters of the tool.
18
+ *
19
+ * This is used to validate the parameters of the tool, as well as to let the LLM know what the
20
+ * parameters are.
21
+ */
22
+ parameters: Params;
23
+ /**
24
+ * The function that executes the tool.
25
+ *
26
+ * This is the main function that will be called when the tool is used.
27
+ *
28
+ * @param args - The arguments of the tool.
29
+ * @param client - The Todoist API client used to make requests to the Todoist API.
30
+ * @returns The result of the tool.
31
+ */
32
+ execute: (args: z.infer<z.ZodObject<Params>>, client: TodoistApi) => Promise<unknown>;
33
+ };
34
+ export type { TodoistTool };
35
+ //# sourceMappingURL=todoist-tool.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"todoist-tool.d.ts","sourceRoot":"","sources":["../../src/todoist-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;GAEG;AACH,KAAK,WAAW,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,IAAI;IAChD;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;;;;;;;OAQG;IACH,OAAO,EAAE,CACR,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAClC,MAAM,EAAE,UAAU,KACd,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB,CAAC;AAEF,YAAY,EAAE,WAAW,EAAE,CAAC"}
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,9 @@
1
+ import type { TodoistApi } from "@doist/todoist-api-typescript";
2
+ declare const accountOverview: {
3
+ name: string;
4
+ description: string;
5
+ parameters: {};
6
+ execute(_args: {}, client: TodoistApi): Promise<string>;
7
+ };
8
+ export { accountOverview };
9
+ //# sourceMappingURL=account-overview.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"account-overview.d.ts","sourceRoot":"","sources":["../../../src/tools/account-overview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,UAAU,EACV,MAAM,+BAA+B,CAAC;AA8EvC,QAAA,MAAM,eAAe;;;;;CA6CqB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,CAAC"}
@@ -0,0 +1,94 @@
1
+ const ArgsSchema = {};
2
+ function buildProjectTree(projects) {
3
+ // Sort projects by childOrder, then build a tree
4
+ const byId = {};
5
+ for (const p of projects) {
6
+ byId[p.id] = {
7
+ ...p,
8
+ children: [],
9
+ childOrder: p.childOrder ?? 0,
10
+ };
11
+ }
12
+ const roots = [];
13
+ for (const p of projects) {
14
+ const current = byId[p.id];
15
+ if (!current)
16
+ continue;
17
+ if (p.parentId) {
18
+ const parent = byId[p.parentId];
19
+ if (parent) {
20
+ parent.children.push(current);
21
+ }
22
+ else {
23
+ roots.push(current);
24
+ }
25
+ }
26
+ else {
27
+ roots.push(current);
28
+ }
29
+ }
30
+ function sortTree(nodes) {
31
+ nodes.sort((a, b) => a.childOrder - b.childOrder);
32
+ for (const n of nodes) {
33
+ sortTree(n.children);
34
+ }
35
+ }
36
+ sortTree(roots);
37
+ return roots;
38
+ }
39
+ async function getSectionsByProject(client, projectIds) {
40
+ const result = {};
41
+ await Promise.all(projectIds.map(async (projectId) => {
42
+ const { results } = await client.getSections({ projectId });
43
+ result[projectId] = results;
44
+ }));
45
+ return result;
46
+ }
47
+ function renderProjectMarkdown(project, sectionsByProject, indent = "") {
48
+ const lines = [];
49
+ lines.push(`${indent}- Project: ${project.name} (id=${project.id})`);
50
+ const sections = sectionsByProject[project.id] || [];
51
+ for (const section of sections) {
52
+ lines.push(`${indent} - Section: ${section.name} (id=${section.id})`);
53
+ }
54
+ for (const child of project.children) {
55
+ lines.push(...renderProjectMarkdown(child, sectionsByProject, `${indent} `));
56
+ }
57
+ return lines;
58
+ }
59
+ const accountOverview = {
60
+ name: "account-overview",
61
+ description: "Get a Markdown overview of all projects (with hierarchy and sections) and the inbox project. Useful in almost any context before engaging with Todoist further.",
62
+ parameters: ArgsSchema,
63
+ async execute(_args, client) {
64
+ const { results: projects } = await client.getProjects({});
65
+ const inbox = projects.find((p) => p.isInboxProject === true);
66
+ const nonInbox = projects.filter((p) => p.isInboxProject !== true);
67
+ const tree = buildProjectTree(nonInbox);
68
+ const allProjectIds = projects.map((p) => p.id);
69
+ const sectionsByProject = await getSectionsByProject(client, allProjectIds);
70
+ const lines = ["# Personal Projects", ""];
71
+ if (inbox) {
72
+ lines.push(`- Inbox Project: ${inbox.name} (id=${inbox.id})`);
73
+ for (const section of sectionsByProject[inbox.id] || []) {
74
+ lines.push(` - Section: ${section.name} (id=${section.id})`);
75
+ }
76
+ }
77
+ if (tree.length) {
78
+ for (const project of tree) {
79
+ lines.push(...renderProjectMarkdown(project, sectionsByProject));
80
+ }
81
+ }
82
+ else {
83
+ lines.push("_No projects found._");
84
+ }
85
+ lines.push("");
86
+ // Add explanation about nesting if there are nested projects
87
+ const hasNested = tree.some((p) => p.children.length > 0);
88
+ if (hasNested) {
89
+ lines.push("_Note: Indentation indicates that a project is a sub-project of the one above it. This allows for organizing projects hierarchically, with parent projects containing related sub-projects._", "");
90
+ }
91
+ return lines.join("\n");
92
+ },
93
+ };
94
+ export { accountOverview };
@@ -0,0 +1,14 @@
1
+ import type { TodoistApi } from "@doist/todoist-api-typescript";
2
+ import { z } from "zod";
3
+ declare const projectOverview: {
4
+ name: string;
5
+ description: string;
6
+ parameters: {
7
+ projectId: z.ZodString;
8
+ };
9
+ execute(args: {
10
+ projectId: string;
11
+ }, client: TodoistApi): Promise<string>;
12
+ };
13
+ export { projectOverview };
14
+ //# sourceMappingURL=project-overview.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-overview.d.ts","sourceRoot":"","sources":["../../../src/tools/project-overview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGX,UAAU,EACV,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA8ExB,QAAA,MAAM,eAAe;;;;;;;;;CA4CqB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,CAAC"}
@@ -0,0 +1,107 @@
1
+ import { z } from "zod";
2
+ import { mapTask } from "./shared.js";
3
+ const ArgsSchema = {
4
+ projectId: z
5
+ .string()
6
+ .min(1)
7
+ .describe("The ID of the project to get an overview for."),
8
+ };
9
+ function buildTaskTree(tasks) {
10
+ const byId = {};
11
+ for (const task of tasks) {
12
+ byId[task.id] = { ...task, children: [] };
13
+ }
14
+ const roots = [];
15
+ for (const task of tasks) {
16
+ const node = byId[task.id];
17
+ if (!node)
18
+ continue;
19
+ if (!task.parentId) {
20
+ roots.push(node);
21
+ continue;
22
+ }
23
+ const parent = byId[task.parentId];
24
+ if (parent) {
25
+ parent.children.push(node);
26
+ }
27
+ else {
28
+ roots.push(node);
29
+ }
30
+ }
31
+ return roots;
32
+ }
33
+ function renderTaskTreeMarkdown(tasks, indent = "") {
34
+ const lines = [];
35
+ for (const task of tasks) {
36
+ const idPart = `id=${task.id}`;
37
+ const duePart = task.dueDate ? `; due=${task.dueDate}` : "";
38
+ const contentPart = `; content=${task.content}`;
39
+ lines.push(`${indent}- ${idPart}${duePart}${contentPart}`);
40
+ if (task.children.length > 0) {
41
+ lines.push(...renderTaskTreeMarkdown(task.children, `${indent} `));
42
+ }
43
+ }
44
+ return lines;
45
+ }
46
+ async function getAllTasksForProject(client, projectId) {
47
+ let allTasks = [];
48
+ let cursor = undefined;
49
+ do {
50
+ const { results, nextCursor } = await client.getTasks({
51
+ projectId,
52
+ limit: 50,
53
+ cursor: cursor ?? undefined,
54
+ });
55
+ allTasks = allTasks.concat(results.map(mapTask));
56
+ cursor = nextCursor ?? undefined;
57
+ } while (cursor);
58
+ return allTasks;
59
+ }
60
+ async function getProjectSections(client, projectId) {
61
+ const { results } = await client.getSections({ projectId });
62
+ return results;
63
+ }
64
+ const projectOverview = {
65
+ name: "project-overview",
66
+ description: "Get a Markdown overview of a single project, including its sections and all tasks. Tasks are grouped by section, with tasks not in any section listed first. Each task is listed as '- id=TASKID; due=YYYY-MM-DD; content=TASK CONTENT' (omit due if not present). Subtasks are nested as indented list items.",
67
+ parameters: ArgsSchema,
68
+ async execute(args, client) {
69
+ const { projectId } = args;
70
+ const project = await client.getProject(projectId);
71
+ const sections = await getProjectSections(client, projectId);
72
+ const allTasks = await getAllTasksForProject(client, projectId);
73
+ // Group tasks by sectionId
74
+ const tasksBySection = {};
75
+ for (const section of sections) {
76
+ tasksBySection[section.id] = [];
77
+ }
78
+ const tasksWithoutSection = [];
79
+ for (const task of allTasks) {
80
+ if (task.sectionId && tasksBySection[task.sectionId]) {
81
+ // biome-ignore lint/style/noNonNullAssertion: the "if" above ensures that it is defined
82
+ tasksBySection[task.sectionId].push(task);
83
+ }
84
+ else {
85
+ tasksWithoutSection.push(task);
86
+ }
87
+ }
88
+ const lines = [`# ${project.name}`];
89
+ if (tasksWithoutSection.length > 0) {
90
+ lines.push("");
91
+ const tree = buildTaskTree(tasksWithoutSection);
92
+ lines.push(...renderTaskTreeMarkdown(tree));
93
+ }
94
+ for (const section of sections) {
95
+ lines.push("");
96
+ lines.push(`## ${section.name}`);
97
+ const sectionTasks = tasksBySection[section.id];
98
+ if (!sectionTasks?.length) {
99
+ continue;
100
+ }
101
+ const tree = buildTaskTree(sectionTasks);
102
+ lines.push(...renderTaskTreeMarkdown(tree));
103
+ }
104
+ return lines.join("\n");
105
+ },
106
+ };
107
+ export { projectOverview };
@@ -0,0 +1,22 @@
1
+ import { z } from "zod";
2
+ declare const projectsAddOne: {
3
+ name: string;
4
+ description: string;
5
+ parameters: {
6
+ name: z.ZodString;
7
+ };
8
+ execute(args: {
9
+ name: string;
10
+ }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
11
+ id: string;
12
+ name: string;
13
+ color: string;
14
+ isFavorite: boolean;
15
+ isShared: boolean;
16
+ parentId: string | null;
17
+ inboxProject: boolean;
18
+ viewStyle: string;
19
+ }>;
20
+ };
21
+ export { projectsAddOne };
22
+ //# sourceMappingURL=projects-add-one.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projects-add-one.d.ts","sourceRoot":"","sources":["../../../src/tools/projects-add-one.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;CAQsB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,CAAC"}
@@ -0,0 +1,15 @@
1
+ import { z } from "zod";
2
+ import { mapProject } from "./shared.js";
3
+ const ArgsSchema = {
4
+ name: z.string().min(1).describe("The name of the project to add."),
5
+ };
6
+ const projectsAddOne = {
7
+ name: "projects-add-one",
8
+ description: "Add a new project.",
9
+ parameters: ArgsSchema,
10
+ async execute(args, client) {
11
+ const project = await client.addProject({ name: args.name });
12
+ return mapProject(project);
13
+ },
14
+ };
15
+ export { projectsAddOne };
@@ -0,0 +1,15 @@
1
+ import { z } from "zod";
2
+ declare const projectsDeleteOne: {
3
+ name: string;
4
+ description: string;
5
+ parameters: {
6
+ id: z.ZodString;
7
+ };
8
+ execute(args: {
9
+ id: string;
10
+ }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
11
+ success: boolean;
12
+ }>;
13
+ };
14
+ export { projectsDeleteOne };
15
+ //# sourceMappingURL=projects-delete-one.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projects-delete-one.d.ts","sourceRoot":"","sources":["../../../src/tools/projects-delete-one.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,QAAA,MAAM,iBAAiB;;;;;;;;;;;CAQmB,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
@@ -0,0 +1,14 @@
1
+ import { z } from "zod";
2
+ const ArgsSchema = {
3
+ id: z.string().min(1).describe("The ID of the project to delete."),
4
+ };
5
+ const projectsDeleteOne = {
6
+ name: "projects-delete-one",
7
+ description: "Delete a project by its ID.",
8
+ parameters: ArgsSchema,
9
+ async execute(args, client) {
10
+ await client.deleteProject(args.id);
11
+ return { success: true };
12
+ },
13
+ };
14
+ export { projectsDeleteOne };
@@ -0,0 +1,18 @@
1
+ import { z } from "zod";
2
+ declare const projectsList: {
3
+ name: string;
4
+ description: string;
5
+ parameters: {
6
+ limit: z.ZodDefault<z.ZodNumber>;
7
+ cursor: z.ZodOptional<z.ZodString>;
8
+ };
9
+ execute(args: {
10
+ limit: number;
11
+ cursor?: string | undefined;
12
+ }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
13
+ projects: import("@doist/todoist-api-typescript").Project[];
14
+ nextCursor: string | null;
15
+ }>;
16
+ };
17
+ export { projectsList };
18
+ //# sourceMappingURL=projects-list.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projects-list.d.ts","sourceRoot":"","sources":["../../../src/tools/projects-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAmBxB,QAAA,MAAM,YAAY;;;;;;;;;;;;;;CAcwB,CAAC;AAE3C,OAAO,EAAE,YAAY,EAAE,CAAC"}
@@ -0,0 +1,30 @@
1
+ import { z } from "zod";
2
+ const ArgsSchema = {
3
+ limit: z
4
+ .number()
5
+ .int()
6
+ .min(1)
7
+ .max(100)
8
+ .default(50)
9
+ .describe("The maximum number of projects to return."),
10
+ cursor: z
11
+ .string()
12
+ .optional()
13
+ .describe("The cursor to get the next page of projects (cursor is obtained from the previous call to this tool, with the same parameters)."),
14
+ };
15
+ const projectsList = {
16
+ name: "projects-list",
17
+ description: "List all projects for the user.",
18
+ parameters: ArgsSchema,
19
+ async execute(args, client) {
20
+ const { results, nextCursor } = await client.getProjects({
21
+ limit: args.limit,
22
+ cursor: args.cursor ?? null,
23
+ });
24
+ return {
25
+ projects: results,
26
+ nextCursor,
27
+ };
28
+ },
29
+ };
30
+ export { projectsList };
@@ -0,0 +1,29 @@
1
+ import { z } from "zod";
2
+ declare const projectsSearch: {
3
+ name: string;
4
+ description: string;
5
+ parameters: {
6
+ search: z.ZodOptional<z.ZodString>;
7
+ limit: z.ZodDefault<z.ZodNumber>;
8
+ cursor: z.ZodOptional<z.ZodString>;
9
+ };
10
+ execute(args: {
11
+ limit: number;
12
+ cursor?: string | undefined;
13
+ search?: string | undefined;
14
+ }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<{
15
+ projects: {
16
+ id: string;
17
+ name: string;
18
+ color: string;
19
+ isFavorite: boolean;
20
+ isShared: boolean;
21
+ parentId: string | null;
22
+ inboxProject: boolean;
23
+ viewStyle: string;
24
+ }[];
25
+ nextCursor: string | null;
26
+ }>;
27
+ };
28
+ export { projectsSearch };
29
+ //# sourceMappingURL=projects-search.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projects-search.d.ts","sourceRoot":"","sources":["../../../src/tools/projects-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0BxB,QAAA,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;CAoBsB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,CAAC"}
@@ -0,0 +1,39 @@
1
+ import { z } from "zod";
2
+ import { mapProject } from "./shared.js";
3
+ const ArgsSchema = {
4
+ search: z
5
+ .string()
6
+ .optional()
7
+ .describe("Search for a project by name (partial and case insensitive match). If omitted, all projects are returned."),
8
+ limit: z
9
+ .number()
10
+ .int()
11
+ .min(1)
12
+ .max(100)
13
+ .default(50)
14
+ .describe("The maximum number of projects to return."),
15
+ cursor: z
16
+ .string()
17
+ .optional()
18
+ .describe("The cursor to get the next page of projects (cursor is obtained from the previous call to this tool, with the same parameters)."),
19
+ };
20
+ const projectsSearch = {
21
+ name: "projects-search",
22
+ description: "Search for projects by name or other criteria.",
23
+ parameters: ArgsSchema,
24
+ async execute(args, client) {
25
+ const { results, nextCursor } = await client.getProjects({
26
+ limit: args.limit,
27
+ cursor: args.cursor ?? null,
28
+ });
29
+ const searchLower = args.search ? args.search.toLowerCase() : undefined;
30
+ const filtered = searchLower
31
+ ? results.filter((project) => project.name.toLowerCase().includes(searchLower))
32
+ : results;
33
+ return {
34
+ projects: filtered.map(mapProject),
35
+ nextCursor,
36
+ };
37
+ },
38
+ };
39
+ export { projectsSearch };
@@ -0,0 +1,15 @@
1
+ import { z } from "zod";
2
+ declare const projectsUpdateOne: {
3
+ name: string;
4
+ description: string;
5
+ parameters: {
6
+ id: z.ZodString;
7
+ name: z.ZodString;
8
+ };
9
+ execute(args: {
10
+ name: string;
11
+ id: string;
12
+ }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<import("@doist/todoist-api-typescript").Project>;
13
+ };
14
+ export { projectsUpdateOne };
15
+ //# sourceMappingURL=projects-update-one.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"projects-update-one.d.ts","sourceRoot":"","sources":["../../../src/tools/projects-update-one.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,QAAA,MAAM,iBAAiB;;;;;;;;;;;CASmB,CAAC;AAE3C,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
@@ -0,0 +1,16 @@
1
+ import { z } from "zod";
2
+ const ArgsSchema = {
3
+ id: z.string().min(1).describe("The ID of the project to update."),
4
+ name: z.string().min(1).describe("The new name for the project."),
5
+ };
6
+ const projectsUpdateOne = {
7
+ name: "projects-update-one",
8
+ description: "Update a project's name by its ID.",
9
+ parameters: ArgsSchema,
10
+ async execute(args, client) {
11
+ const { id, name } = args;
12
+ const project = await client.updateProject(id, { name });
13
+ return project;
14
+ },
15
+ };
16
+ export { projectsUpdateOne };
@@ -0,0 +1,15 @@
1
+ import { z } from "zod";
2
+ declare const sectionsAddOne: {
3
+ name: string;
4
+ description: string;
5
+ parameters: {
6
+ name: z.ZodString;
7
+ projectId: z.ZodString;
8
+ };
9
+ execute(args: {
10
+ name: string;
11
+ projectId: string;
12
+ }, client: import("@doist/todoist-api-typescript").TodoistApi): Promise<import("@doist/todoist-api-typescript").Section>;
13
+ };
14
+ export { sectionsAddOne };
15
+ //# sourceMappingURL=sections-add-one.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sections-add-one.d.ts","sourceRoot":"","sources":["../../../src/tools/sections-add-one.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,QAAA,MAAM,cAAc;;;;;;;;;;;CAWsB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,CAAC"}