todoist-mcp 1.3.2 → 1.3.4

package/README.md

@@ -20,6 +20,7 @@
 - **Projects**: Create and manage projects and sections
 - **Comments**: Add and manage comments on tasks and projects
 - **Labels**: Create and manage personal and shared labels
+- **Smart Context**: On startup, automatically provides your projects and labels to the AI via server instructions — no extra tool calls needed
 - **Prompt Support**: You can easily provide information about your projects to client
 
 ## Configuration
@@ -73,7 +74,8 @@ API_KEY = "your_todoist_api_token"
 
 ### Tasks
 
-- `get_tasks_list`: Get tasks with optional filtering by project, section, label, etc.
+- `get_tasks_list`: Get tasks with optional filtering by project, section, label, or IDs
+- `get_tasks_by_filter`: Get tasks using Todoist filter language (e.g. `"today"`, `"overdue"`, `"P1 | P2"`, `"#Work & @urgent"`)
 - `create_tasks`: Create new tasks with various attributes
 - `get_tasks`: Get specific tasks by ID or name
 - `update_tasks`: Update existing tasks

package/dist/index.js

@@ -2,6 +2,7 @@
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { server } from './clients.js';
 import { config, log } from './utils/helpers.js';
+import { buildInstructions } from './utils/instructions.js';
 import './prompts.js';
 import './tools.js';
 export async function main() {
@@ -10,6 +11,8 @@ export async function main() {
         process.exit(1);
     }
     try {
+        server.server._instructions =
+            await buildInstructions();
         const transport = new StdioServerTransport();
         await server.connect(transport);
         process.stdin.resume();

package/dist/tools/sync.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tools/sync.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { todoistApi } from '../clients.js';
+import { createHandler } from '../utils/handlers.js';
+const VALID_RESOURCE_TYPES = [
+    'labels',
+    'projects',
+    'items',
+    'notes',
+    'sections',
+    'filters',
+    'reminders',
+    'locations',
+    'user',
+    'live_notifications',
+    'collaborators',
+    'user_settings',
+    'notification_settings',
+    'user_plan_limits',
+    'completed_info',
+    'stats',
+    'workspaces',
+    'workspace_users',
+];
+createHandler('read_resources', `Read resources from the Todoist Sync API. Fetches one or more resource types in a single request. Available resource types: ${VALID_RESOURCE_TYPES.join(', ')}. Use sync_token '*' for a full sync, or pass a previously returned sync_token for incremental updates.`, {
+    resource_types: z
+        .array(z.string())
+        .min(1)
+        .describe(`Array of resource types to fetch. Valid types: ${VALID_RESOURCE_TYPES.join(', ')}`),
+    sync_token: z
+        .string()
+        .optional()
+        .default('*')
+        .describe('Sync token for incremental sync. Use "*" for full sync (default)'),
+}, async (args) => {
+    return todoistApi.readResources(args.resource_types, args.sync_token);
+});

package/dist/tools/tasks.js

@@ -12,7 +12,13 @@ const create_fields = {
         .optional()
         .describe('Description (detailed). May contain markdown-formatted text and hyperlinks'),
     labels: z.array(z.string()).optional(),
-    priority: z.number().int().min(1).max(4).optional().describe('From 1 (urgent) to 4 (normal)'),
+    priority: z
+        .number()
+        .int()
+        .min(1)
+        .max(4)
+        .optional()
+        .describe('Todoist API priority (1-4): pass 4 when the user says "P1" or "highest priority", and pass 1 for "P4" or lowest priority'),
     due_string: z
         .string()
         .optional()

package/dist/utils/handlers.js

@@ -49,7 +49,7 @@ export function createHandler(name, description, paramsSchema, handler) {
             };
         }
     };
-    // Crazy cast, if you can do it better, please, let me knows
+    // Cast needed: SDK uses Zod 4 types internally, project uses Zod 3
     server.tool(name, description, paramsSchema, mcpToolCallback);
 }
 export function createApiHandler(options) {

package/dist/utils/instructions.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Fetches user context (projects, labels) and builds dynamic server instructions
+ */
+export declare function buildInstructions(): Promise<string>;

package/dist/utils/instructions.js

@@ -0,0 +1,49 @@
+import { todoistApi } from '../clients.js';
+import { log } from './helpers.js';
+const HEADER = 'Use this server to interact with Todoist API.';
+const PREVIEW_LIMIT = 20;
+const NOTES = [
+    'Notes:',
+    '- Todoist API priority is inverted: P1 (urgent) = 4, P2 = 3, P3 = 2, P4 (normal) = 1',
+].join('\n');
+/**
+ * Truncates a list and appends "(+N more)" if it exceeds the limit
+ */
+function truncateList(items) {
+    const visible = items.slice(0, PREVIEW_LIMIT);
+    const remaining = items.length - visible.length;
+    const result = visible.join(', ');
+    return remaining > 0 ? `${result} (+${remaining} more)` : result;
+}
+/**
+ * Fetches user context (projects, labels) and builds dynamic server instructions
+ */
+export async function buildInstructions() {
+    try {
+        const [projects, personalLabels, sharedLabels] = await Promise.all([
+            todoistApi.get('/projects', {}),
+            todoistApi.get('/labels', {}),
+            todoistApi.get('/labels/shared', {}),
+        ]);
+        const parts = [HEADER];
+        if (Array.isArray(projects) && projects.length > 0) {
+            const projectList = projects
+                .map((p) => `- ${p.name} (id: ${p.id})`)
+                .join('\n');
+            parts.push(`\nUser projects:\n${projectList}`);
+        }
+        if (Array.isArray(personalLabels) && personalLabels.length > 0) {
+            const names = personalLabels.map((l) => l.name);
+            parts.push(`\nPersonal labels: ${truncateList(names)}`);
+        }
+        if (Array.isArray(sharedLabels) && sharedLabels.length > 0) {
+            parts.push(`\nShared labels: ${truncateList(sharedLabels)}`);
+        }
+        parts.push(`\n${NOTES}`);
+        return parts.join('');
+    }
+    catch (error) {
+        log('Failed to fetch user context for instructions:', error);
+        return `${HEADER}\n\n${NOTES}`;
+    }
+}

package/dist/utils/types.d.ts

@@ -1,6 +1,5 @@
-import { CallToolRequestSchema, Result } from '@modelcontextprotocol/sdk/types.js';
-import z from 'zod';
-export type ToolHandlers = Record<string, (request: z.infer<typeof CallToolRequestSchema>) => Promise<Result>>;
+import { CallToolRequest, Result } from '@modelcontextprotocol/sdk/types.js';
+export type ToolHandlers = Record<string, (request: CallToolRequest) => Promise<Result>>;
 export type ToolResult = {
     content: Array<{
         type: string;

package/dist/utils/version.d.ts

@@ -1 +1 @@
-export declare const version = "1.3.2";
+export declare const version = "1.3.4";

package/dist/utils/version.js

@@ -1,2 +1,2 @@
 // Auto-generated file, do not edit
-export const version = '1.3.2';
+export const version = '1.3.4';

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "todoist-mcp",
-    "version": "1.3.2",
+    "version": "1.3.4",
     "description": "Todoist MCP Server",
     "type": "module",
     "main": "dist/index.js",