@doist/todoist-ai 4.9.4 → 4.11.0

package/dist/tools/search.js

@@ -0,0 +1,64 @@
+import { z } from 'zod';
+import { getErrorOutput } from '../mcp-helpers.js';
+import { buildTodoistUrl, getTasksByFilter } from '../tool-helpers.js';
+import { ApiLimits } from '../utils/constants.js';
+import { ToolNames } from '../utils/tool-names.js';
+const ArgsSchema = {
+    query: z.string().min(1).describe('The search query string to find tasks and projects.'),
+};
+/**
+ * OpenAI MCP search tool - returns a list of relevant search results from Todoist.
+ *
+ * This tool follows the OpenAI MCP search tool specification:
+ * @see https://platform.openai.com/docs/mcp#search-tool
+ */
+const search = {
+    name: ToolNames.SEARCH,
+    description: 'Search across tasks and projects in Todoist. Returns a list of relevant results with IDs, titles, and URLs.',
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        try {
+            const { query } = args;
+            // Search both tasks and projects in parallel
+            // Use TASKS_MAX for search since this tool doesn't support pagination
+            const [tasksResult, projectsResponse] = await Promise.all([
+                getTasksByFilter({
+                    client,
+                    query: `search: ${query}`,
+                    limit: ApiLimits.TASKS_MAX,
+                    cursor: undefined,
+                }),
+                client.getProjects({ limit: ApiLimits.PROJECTS_MAX }),
+            ]);
+            // Filter projects by search query (case-insensitive)
+            const searchLower = query.toLowerCase();
+            const matchingProjects = projectsResponse.results.filter((project) => project.name.toLowerCase().includes(searchLower));
+            // Build results array
+            const results = [];
+            // Add task results with composite IDs
+            for (const task of tasksResult.tasks) {
+                results.push({
+                    id: `task:${task.id}`,
+                    title: task.content,
+                    url: buildTodoistUrl('task', task.id),
+                });
+            }
+            // Add project results with composite IDs
+            for (const project of matchingProjects) {
+                results.push({
+                    id: `project:${project.id}`,
+                    title: project.name,
+                    url: buildTodoistUrl('project', project.id),
+                });
+            }
+            // Return as JSON-encoded string in a text content item (OpenAI MCP spec)
+            const jsonText = JSON.stringify({ results });
+            return { content: [{ type: 'text', text: jsonText }] };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'An unknown error occurred';
+            return getErrorOutput(message);
+        }
+    },
+};
+export { search };

package/dist/tools/update-tasks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-tasks.d.ts","sourceRoot":"","sources":["../../src/tools/update-tasks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAoDvB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkHyB,CAAA;AAqC1C,OAAO,EAAE,WAAW,EAAE,CAAA"}
+{"version":3,"file":"update-tasks.d.ts","sourceRoot":"","sources":["../../src/tools/update-tasks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA8DvB,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkHyB,CAAA;AAqC1C,OAAO,EAAE,WAAW,EAAE,CAAA"}

package/dist/tools/update-tasks.js

@@ -9,8 +9,14 @@ import { ToolNames } from '../utils/tool-names.js';
 const { FIND_TASKS_BY_DATE, GET_OVERVIEW } = ToolNames;
 const TasksUpdateSchema = z.object({
     id: z.string().min(1).describe('The ID of the task to update.'),
-    content: z.string().optional().describe('The new content of the task.'),
-    description: z.string().optional().describe('The new description of the task.'),
+    content: z
+        .string()
+        .optional()
+        .describe('The new task name/title. Should be concise and actionable (e.g., "Review PR #123", "Call dentist"). For longer content, use the description field instead. Supports Markdown.'),
+    description: z
+        .string()
+        .optional()
+        .describe('New additional details, notes, or context for the task. Use this for longer content rather than putting it in the task name. Supports Markdown.'),
     projectId: z.string().optional().describe('The new project ID for the task.'),
     sectionId: z.string().optional().describe('The new section ID for the task.'),
     parentId: z.string().optional().describe('The new parent task ID (for subtasks).'),

package/dist/utils/constants.d.ts

@@ -8,7 +8,7 @@ export declare const ApiLimits: {
     /** Default limit for task listings */
     readonly TASKS_DEFAULT: 10;
     /** Maximum limit for task search and list operations */
-    readonly TASKS_MAX: 50;
+    readonly TASKS_MAX: 100;
     /** Default limit for completed tasks */
     readonly COMPLETED_TASKS_DEFAULT: 50;
     /** Maximum limit for completed tasks */

package/dist/utils/constants.js

@@ -9,7 +9,7 @@ export const ApiLimits = {
     /** Default limit for task listings */
     TASKS_DEFAULT: 10,
     /** Maximum limit for task search and list operations */
-    TASKS_MAX: 50,
+    TASKS_MAX: 100,
     /** Default limit for completed tasks */
     COMPLETED_TASKS_DEFAULT: 50,
     /** Maximum limit for completed tasks */

package/dist/utils/tool-names.d.ts

@@ -26,6 +26,8 @@ export declare const ToolNames: {
     readonly GET_OVERVIEW: "get-overview";
     readonly DELETE_OBJECT: "delete-object";
     readonly USER_INFO: "user-info";
+    readonly SEARCH: "search";
+    readonly FETCH: "fetch";
 };
 export type ToolName = (typeof ToolNames)[keyof typeof ToolNames];
 //# sourceMappingURL=tool-names.d.ts.map

package/dist/utils/tool-names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-names.d.ts","sourceRoot":"","sources":["../../src/utils/tool-names.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;CAgCZ,CAAA;AAGV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA"}
+{"version":3,"file":"tool-names.d.ts","sourceRoot":"","sources":["../../src/utils/tool-names.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;;;;;;;CAoCZ,CAAA;AAGV,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,OAAO,SAAS,CAAC,CAAA"}

package/dist/utils/tool-names.js

@@ -32,4 +32,7 @@ export const ToolNames = {
     GET_OVERVIEW: 'get-overview',
     DELETE_OBJECT: 'delete-object',
     USER_INFO: 'user-info',
+    // OpenAI MCP tools
+    SEARCH: 'search',
+    FETCH: 'fetch',
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@doist/todoist-ai",
-    "version": "4.9.4",
+    "version": "4.11.0",
     "type": "module",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",