@doist/todoist-ai 0.1.0

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Ernesto García
+
+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.

package/README.md

@@ -0,0 +1,93 @@
+# Todoist AI SDK
+
+Library for connecting AI agents to Todoist. Includes tools that can be integrated into LLMs,
+enabling them to access and modify a Todoist account on the user's behalf.
+
+These tools can be used both through an MCP server, or imported directly in other projects to
+integrate them to your own AI conversational interfaces.
+
+## Using tools
+
+### 1. Add this repository as a dependency
+
+```sh
+npm install @doist/todoist-ai
+```
+
+### 2. Import the tools and plug them to an AI
+
+Here's an example using [Vercel's AI SDK](https://ai-sdk.dev/docs/ai-sdk-core/generating-text#streamtext).
+
+```js
+import { tasksListByDate, tasksAddMultiple } from "@doist/todoist-ai/tools";
+import { streamText } from "ai";
+
+const result = streamText({
+    model: yourModel,
+    system: "You are a helpful Todoist assistant",
+    tools: {
+        tasksListByDate,
+        tasksAddMultiple,
+    },
+});
+```
+
+## Using as an MCP server
+
+For convenience, we already include a function that initializes an MCP Server with all the tools available:
+
+```js
+import { getMcpServer } from "@doist/todoist-ai";
+
+async function main() {
+    const server = getMcpServer({ todoistApiKey: process.env.TODOIST_API_KEY });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+```
+
+## Features
+
+A key feature of this project is that tools can be reused, and are not written specifically for use in an MCP server. They can be hooked up as tools to other conversational AI interfaces (e.g. Vercel's AI SDK).
+
+This project is in its early stages. Expect more and/or better tools soon.
+
+Nevertheless, our goal is to provide a small set of tools that enable complete workflows, rather than just atomic actions, striking a balance between flexibility and efficiency for LLMs.
+
+### Available Tools
+
+-   **account-overview**: Get a Markdown overview of all projects (with hierarchy and sections) and the inbox project.
+-   **project-overview**: 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.
+-   **projects-list**: List all projects for the user.
+-   **projects-search**: Search for projects by name or other criteria.
+-   **projects-add-one**: Add a new project.
+-   **projects-update-one**: Update a project's name by its ID.
+-   **projects-delete-one**: Delete a project by its ID.
+-   **sections-search**: Search for sections by name or other criteria in a project.
+-   **sections-add-one**: Add a new section to a project.
+-   **sections-update-one**: Update a section's name by its ID.
+-   **sections-delete-one**: Delete a section by its ID.
+-   **tasks-list-by-date**: Get tasks by date range.
+-   **tasks-list-overdue**: Get overdue tasks.
+-   **tasks-list-for-project**: Get tasks by project ID.
+-   **tasks-list-for-section**: List tasks for a given section.
+-   **tasks-search**: Search tasks by text using Todoist's filter query.
+-   **tasks-add-multiple**: Add one or more tasks to a project, section, or parent.
+-   **tasks-update-one**: Update an existing task with new values.
+-   **tasks-delete-one**: Delete a task by its ID.
+-   **tasks-complete-multiple**: Complete one or multiple tasks by ID.
+-   **tasks-organize-multiple**: Organize multiple tasks (move, reorder, etc.) in bulk.
+-   **subtasks-list-for-parent-task**: List subtasks for a given parent task.
+
+## Dependencies
+
+-   MCP server using the official [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk?tab=readme-ov-file#installation)
+-   Todoist Typescript API client [@doist/todoist-api-typescript](https://github.com/Doist/todoist-api-typescript)
+
+## MCP Server Setup
+
+See [docs/mcp-server.md](docs/mcp-server.md) for full instructions on setting up the MCP server.
+
+## Local Development Setup
+
+See [docs/dev-setup.md](docs/dev-setup.md) for full instructions on setting up this repository locally for development and contributing.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { getMcpServer } from "./mcp-server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export { getMcpServer } from "./mcp-server.js";

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -0,0 +1,23 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import dotenv from "dotenv";
+import { getMcpServer } from "./mcp-server.js";
+function main() {
+    const todoistApiKey = process.env.TODOIST_API_KEY;
+    if (!todoistApiKey) {
+        throw new Error("TODOIST_API_KEY is not set");
+    }
+    const server = getMcpServer({ todoistApiKey });
+    const transport = new StdioServerTransport();
+    server
+        .connect(transport)
+        .then(() => {
+        // We use console.error because standard I/O is being used for the MCP server communication.
+        console.error("Server started");
+    })
+        .catch((error) => {
+        console.error("Error starting the Todoist MCP server:", error);
+        process.exit(1);
+    });
+}
+dotenv.config();
+main();

package/dist/mcp-helpers.d.ts

@@ -0,0 +1,13 @@
+import type { TodoistApi } from "@doist/todoist-api-typescript";
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { z } from "zod";
+import type { TodoistTool } from "./todoist-tool.js";
+/**
+ * Register a Todoist tool in an MCP server.
+ * @param tool - The tool to register.
+ * @param server - The server to register the tool on.
+ * @param client - The Todoist API client to use to execute the tool.
+ */
+declare function registerTool<Params extends z.ZodRawShape>(tool: TodoistTool<Params>, server: McpServer, client: TodoistApi): void;
+export { registerTool };
+//# sourceMappingURL=mcp-helpers.d.ts.map

package/dist/mcp-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-helpers.d.ts","sourceRoot":"","sources":["../src/mcp-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,EACX,SAAS,EAET,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAc,CAAC,EAAE,MAAM,KAAK,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA+BrD;;;;;GAKG;AACH,iBAAS,YAAY,CAAC,MAAM,SAAS,CAAC,CAAC,WAAW,EACjD,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,EACzB,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,QA2BlB;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/mcp-helpers.js

@@ -0,0 +1,52 @@
+function textContent(text) {
+    return {
+        content: [{ type: "text", text }],
+    };
+}
+function jsonContent(data) {
+    return {
+        content: [
+            {
+                type: "text",
+                mimeType: "application/json",
+                text: JSON.stringify(data, null, 2),
+            },
+        ],
+    };
+}
+function textOrJsonContent(data) {
+    return typeof data === "string" ? textContent(data) : jsonContent(data);
+}
+function errorContent(error) {
+    return {
+        ...textContent(error),
+        isError: true,
+    };
+}
+/**
+ * Register a Todoist tool in an MCP server.
+ * @param tool - The tool to register.
+ * @param server - The server to register the tool on.
+ * @param client - The Todoist API client to use to execute the tool.
+ */
+function registerTool(tool, server, client) {
+    // @ts-ignore I give up
+    const cb = async (args, _context) => {
+        try {
+            const result = await tool.execute(args, client);
+            return textOrJsonContent(result);
+        }
+        catch (error) {
+            console.error(`Error executing tool ${tool.name}:`, {
+                args,
+                error,
+            });
+            const message = error instanceof Error
+                ? error.message
+                : "An unknown error occurred";
+            return errorContent(message);
+        }
+    };
+    server.tool(tool.name, tool.description, tool.parameters, cb);
+}
+export { registerTool };

package/dist/mcp-server.d.ts

@@ -0,0 +1,11 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Create the MCP server.
+ * @param todoistApiKey - The API key for the todoist account.
+ * @returns the MCP server.
+ */
+declare function getMcpServer({ todoistApiKey }: {
+    todoistApiKey: string;
+}): McpServer;
+export { getMcpServer };
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAiCpE;;;;GAIG;AACH,iBAAS,YAAY,CAAC,EAAE,aAAa,EAAE,EAAE;IAAE,aAAa,EAAE,MAAM,CAAA;CAAE,aAqCjE;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/mcp-server.js

@@ -0,0 +1,66 @@
+import { TodoistApi } from "@doist/todoist-api-typescript";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerTool } from "./mcp-helpers.js";
+import { projectsAddOne } from "./tools/projects-add-one.js";
+import { projectsDeleteOne } from "./tools/projects-delete-one.js";
+import { projectsList } from "./tools/projects-list.js";
+import { projectsSearch } from "./tools/projects-search.js";
+import { projectsUpdateOne } from "./tools/projects-update-one.js";
+import { sectionsAddOne } from "./tools/sections-add-one.js";
+import { sectionsDeleteOne } from "./tools/sections-delete-one.js";
+import { sectionsSearch } from "./tools/sections-search.js";
+import { sectionsUpdateOne } from "./tools/sections-update-one.js";
+import { subtasksListForParentTask } from "./tools/subtasks-list-for-parent-task.js";
+import { accountOverview } from "./tools/account-overview.js";
+import { projectOverview } from "./tools/project-overview.js";
+import { tasksAddMultiple } from "./tools/tasks-add-multiple.js";
+import { tasksListByDate } from "./tools/tasks-by-date-range.js";
+import { tasksListForProject } from "./tools/tasks-by-project.js";
+import { tasksCompleteMultiple } from "./tools/tasks-complete-multiple.js";
+import { tasksDeleteOne } from "./tools/tasks-delete-one.js";
+import { tasksListForSection } from "./tools/tasks-list-for-section.js";
+import { tasksListOverdue } from "./tools/tasks-list-overdue.js";
+import { tasksOrganizeMultiple } from "./tools/tasks-organize-multiple.js";
+import { tasksSearch } from "./tools/tasks-search.js";
+import { tasksUpdateOne } from "./tools/tasks-update-one.js";
+const instructions = `
+Tools to help you manage your todoist tasks.
+`;
+/**
+ * Create the MCP server.
+ * @param todoistApiKey - The API key for the todoist account.
+ * @returns the MCP server.
+ */
+function getMcpServer({ todoistApiKey }) {
+    const server = new McpServer({ name: "todoist-mcp-server", version: "0.1.0" }, {
+        capabilities: {
+            tools: { listChanged: true },
+        },
+        instructions,
+    });
+    const todoist = new TodoistApi(todoistApiKey);
+    registerTool(tasksListByDate, server, todoist);
+    registerTool(tasksListOverdue, server, todoist);
+    registerTool(tasksListForProject, server, todoist);
+    registerTool(tasksSearch, server, todoist);
+    registerTool(projectsList, server, todoist);
+    registerTool(tasksAddMultiple, server, todoist);
+    registerTool(tasksUpdateOne, server, todoist);
+    registerTool(tasksDeleteOne, server, todoist);
+    registerTool(tasksCompleteMultiple, server, todoist);
+    registerTool(projectsAddOne, server, todoist);
+    registerTool(projectsUpdateOne, server, todoist);
+    registerTool(sectionsAddOne, server, todoist);
+    registerTool(sectionsUpdateOne, server, todoist);
+    registerTool(tasksOrganizeMultiple, server, todoist);
+    registerTool(subtasksListForParentTask, server, todoist);
+    registerTool(tasksListForSection, server, todoist);
+    registerTool(projectsDeleteOne, server, todoist);
+    registerTool(projectsSearch, server, todoist);
+    registerTool(sectionsDeleteOne, server, todoist);
+    registerTool(sectionsSearch, server, todoist);
+    registerTool(accountOverview, server, todoist);
+    registerTool(projectOverview, server, todoist);
+    return server;
+}
+export { getMcpServer };

package/dist/todoist-tool.d.ts

@@ -0,0 +1,35 @@
+import type { TodoistApi } from "@doist/todoist-api-typescript";
+import type { z } from "zod";
+/**
+ * A Todoist tool that can be used in an MCP server or other conversational AI interfaces.
+ */
+type TodoistTool<Params extends z.ZodRawShape> = {
+    /**
+     * The name of the tool.
+     */
+    name: string;
+    /**
+     * The description of the tool. This is important for the LLM to understand what the tool does,
+     * and how to use it.
+     */
+    description: string;
+    /**
+     * The schema of the parameters of the tool.
+     *
+     * This is used to validate the parameters of the tool, as well as to let the LLM know what the
+     * parameters are.
+     */
+    parameters: Params;
+    /**
+     * The function that executes the tool.
+     *
+     * This is the main function that will be called when the tool is used.
+     *
+     * @param args - The arguments of the tool.
+     * @param client - The Todoist API client used to make requests to the Todoist API.
+     * @returns The result of the tool.
+     */
+    execute: (args: z.infer<z.ZodObject<Params>>, client: TodoistApi) => Promise<unknown>;
+};
+export type { TodoistTool };
+//# sourceMappingURL=todoist-tool.d.ts.map

package/dist/todoist-tool.d.ts.map

@@ -0,0 +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"}

package/dist/todoist-tool.js

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

package/dist/tools/account-overview.d.ts

@@ -0,0 +1,9 @@
+import type { TodoistApi } from "@doist/todoist-api-typescript";
+declare const accountOverview: {
+    name: string;
+    description: string;
+    parameters: {};
+    execute(_args: {}, client: TodoistApi): Promise<string>;
+};
+export { accountOverview };
+//# sourceMappingURL=account-overview.d.ts.map

package/dist/tools/account-overview.d.ts.map

@@ -0,0 +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"}

package/dist/tools/account-overview.js

@@ -0,0 +1,94 @@
+const ArgsSchema = {};
+function buildProjectTree(projects) {
+    // Sort projects by childOrder, then build a tree
+    const byId = {};
+    for (const p of projects) {
+        byId[p.id] = {
+            ...p,
+            children: [],
+            childOrder: p.childOrder ?? 0,
+        };
+    }
+    const roots = [];
+    for (const p of projects) {
+        const current = byId[p.id];
+        if (!current)
+            continue;
+        if (p.parentId) {
+            const parent = byId[p.parentId];
+            if (parent) {
+                parent.children.push(current);
+            }
+            else {
+                roots.push(current);
+            }
+        }
+        else {
+            roots.push(current);
+        }
+    }
+    function sortTree(nodes) {
+        nodes.sort((a, b) => a.childOrder - b.childOrder);
+        for (const n of nodes) {
+            sortTree(n.children);
+        }
+    }
+    sortTree(roots);
+    return roots;
+}
+async function getSectionsByProject(client, projectIds) {
+    const result = {};
+    await Promise.all(projectIds.map(async (projectId) => {
+        const { results } = await client.getSections({ projectId });
+        result[projectId] = results;
+    }));
+    return result;
+}
+function renderProjectMarkdown(project, sectionsByProject, indent = "") {
+    const lines = [];
+    lines.push(`${indent}- Project: ${project.name} (id=${project.id})`);
+    const sections = sectionsByProject[project.id] || [];
+    for (const section of sections) {
+        lines.push(`${indent}  - Section: ${section.name} (id=${section.id})`);
+    }
+    for (const child of project.children) {
+        lines.push(...renderProjectMarkdown(child, sectionsByProject, `${indent}  `));
+    }
+    return lines;
+}
+const accountOverview = {
+    name: "account-overview",
+    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.",
+    parameters: ArgsSchema,
+    async execute(_args, client) {
+        const { results: projects } = await client.getProjects({});
+        const inbox = projects.find((p) => p.isInboxProject === true);
+        const nonInbox = projects.filter((p) => p.isInboxProject !== true);
+        const tree = buildProjectTree(nonInbox);
+        const allProjectIds = projects.map((p) => p.id);
+        const sectionsByProject = await getSectionsByProject(client, allProjectIds);
+        const lines = ["# Personal Projects", ""];
+        if (inbox) {
+            lines.push(`- Inbox Project: ${inbox.name} (id=${inbox.id})`);
+            for (const section of sectionsByProject[inbox.id] || []) {
+                lines.push(`  - Section: ${section.name} (id=${section.id})`);
+            }
+        }
+        if (tree.length) {
+            for (const project of tree) {
+                lines.push(...renderProjectMarkdown(project, sectionsByProject));
+            }
+        }
+        else {
+            lines.push("_No projects found._");
+        }
+        lines.push("");
+        // Add explanation about nesting if there are nested projects
+        const hasNested = tree.some((p) => p.children.length > 0);
+        if (hasNested) {
+            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._", "");
+        }
+        return lines.join("\n");
+    },
+};
+export { accountOverview };

package/dist/tools/index.d.ts

@@ -0,0 +1,23 @@
+export { projectsList } from "./projects-list.js";
+export { projectsSearch } from "./projects-search.js";
+export { projectsAddOne } from "./projects-add-one.js";
+export { projectsUpdateOne } from "./projects-update-one.js";
+export { projectsDeleteOne } from "./projects-delete-one.js";
+export { sectionsSearch } from "./sections-search.js";
+export { sectionsAddOne } from "./sections-add-one.js";
+export { sectionsUpdateOne } from "./sections-update-one.js";
+export { sectionsDeleteOne } from "./sections-delete-one.js";
+export { tasksListByDate } from "./tasks-by-date-range.js";
+export { tasksDeleteOne } from "./tasks-delete-one.js";
+export { tasksCompleteMultiple } from "./tasks-complete-multiple.js";
+export { tasksListForProject } from "./tasks-by-project.js";
+export { tasksListOverdue } from "./tasks-list-overdue.js";
+export { tasksSearch } from "./tasks-search.js";
+export { tasksAddMultiple } from "./tasks-add-multiple.js";
+export { tasksUpdateOne } from "./tasks-update-one.js";
+export { tasksOrganizeMultiple } from "./tasks-organize-multiple.js";
+export { tasksListForSection } from "./tasks-list-for-section.js";
+export { subtasksListForParentTask } from "./subtasks-list-for-parent-task.js";
+export { accountOverview } from "./account-overview.js";
+export { projectOverview } from "./project-overview.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,22 @@
+export { projectsList } from "./projects-list.js";
+export { projectsSearch } from "./projects-search.js";
+export { projectsAddOne } from "./projects-add-one.js";
+export { projectsUpdateOne } from "./projects-update-one.js";
+export { projectsDeleteOne } from "./projects-delete-one.js";
+export { sectionsSearch } from "./sections-search.js";
+export { sectionsAddOne } from "./sections-add-one.js";
+export { sectionsUpdateOne } from "./sections-update-one.js";
+export { sectionsDeleteOne } from "./sections-delete-one.js";
+export { tasksListByDate } from "./tasks-by-date-range.js";
+export { tasksDeleteOne } from "./tasks-delete-one.js";
+export { tasksCompleteMultiple } from "./tasks-complete-multiple.js";
+export { tasksListForProject } from "./tasks-by-project.js";
+export { tasksListOverdue } from "./tasks-list-overdue.js";
+export { tasksSearch } from "./tasks-search.js";
+export { tasksAddMultiple } from "./tasks-add-multiple.js";
+export { tasksUpdateOne } from "./tasks-update-one.js";
+export { tasksOrganizeMultiple } from "./tasks-organize-multiple.js";
+export { tasksListForSection } from "./tasks-list-for-section.js";
+export { subtasksListForParentTask } from "./subtasks-list-for-parent-task.js";
+export { accountOverview } from "./account-overview.js";
+export { projectOverview } from "./project-overview.js";

package/dist/tools/project-overview.d.ts

@@ -0,0 +1,14 @@
+import type { TodoistApi } from "@doist/todoist-api-typescript";
+import { z } from "zod";
+declare const projectOverview: {
+    name: string;
+    description: string;
+    parameters: {
+        projectId: z.ZodString;
+    };
+    execute(args: {
+        projectId: string;
+    }, client: TodoistApi): Promise<string>;
+};
+export { projectOverview };
+//# sourceMappingURL=project-overview.d.ts.map

package/dist/tools/project-overview.d.ts.map

@@ -0,0 +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"}

package/dist/tools/project-overview.js

@@ -0,0 +1,107 @@
+import { z } from "zod";
+import { mapTask } from "./shared.js";
+const ArgsSchema = {
+    projectId: z
+        .string()
+        .min(1)
+        .describe("The ID of the project to get an overview for."),
+};
+function buildTaskTree(tasks) {
+    const byId = {};
+    for (const task of tasks) {
+        byId[task.id] = { ...task, children: [] };
+    }
+    const roots = [];
+    for (const task of tasks) {
+        const node = byId[task.id];
+        if (!node)
+            continue;
+        if (!task.parentId) {
+            roots.push(node);
+            continue;
+        }
+        const parent = byId[task.parentId];
+        if (parent) {
+            parent.children.push(node);
+        }
+        else {
+            roots.push(node);
+        }
+    }
+    return roots;
+}
+function renderTaskTreeMarkdown(tasks, indent = "") {
+    const lines = [];
+    for (const task of tasks) {
+        const idPart = `id=${task.id}`;
+        const duePart = task.dueDate ? `; due=${task.dueDate}` : "";
+        const contentPart = `; content=${task.content}`;
+        lines.push(`${indent}- ${idPart}${duePart}${contentPart}`);
+        if (task.children.length > 0) {
+            lines.push(...renderTaskTreeMarkdown(task.children, `${indent}  `));
+        }
+    }
+    return lines;
+}
+async function getAllTasksForProject(client, projectId) {
+    let allTasks = [];
+    let cursor = undefined;
+    do {
+        const { results, nextCursor } = await client.getTasks({
+            projectId,
+            limit: 50,
+            cursor: cursor ?? undefined,
+        });
+        allTasks = allTasks.concat(results.map(mapTask));
+        cursor = nextCursor ?? undefined;
+    } while (cursor);
+    return allTasks;
+}
+async function getProjectSections(client, projectId) {
+    const { results } = await client.getSections({ projectId });
+    return results;
+}
+const projectOverview = {
+    name: "project-overview",
+    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.",
+    parameters: ArgsSchema,
+    async execute(args, client) {
+        const { projectId } = args;
+        const project = await client.getProject(projectId);
+        const sections = await getProjectSections(client, projectId);
+        const allTasks = await getAllTasksForProject(client, projectId);
+        // Group tasks by sectionId
+        const tasksBySection = {};
+        for (const section of sections) {
+            tasksBySection[section.id] = [];
+        }
+        const tasksWithoutSection = [];
+        for (const task of allTasks) {
+            if (task.sectionId && tasksBySection[task.sectionId]) {
+                // biome-ignore lint/style/noNonNullAssertion: the "if" above ensures that it is defined
+                tasksBySection[task.sectionId].push(task);
+            }
+            else {
+                tasksWithoutSection.push(task);
+            }
+        }
+        const lines = [`# ${project.name}`];
+        if (tasksWithoutSection.length > 0) {
+            lines.push("");
+            const tree = buildTaskTree(tasksWithoutSection);
+            lines.push(...renderTaskTreeMarkdown(tree));
+        }
+        for (const section of sections) {
+            lines.push("");
+            lines.push(`## ${section.name}`);
+            const sectionTasks = tasksBySection[section.id];
+            if (!sectionTasks?.length) {
+                continue;
+            }
+            const tree = buildTaskTree(sectionTasks);
+            lines.push(...renderTaskTreeMarkdown(tree));
+        }
+        return lines.join("\n");
+    },
+};
+export { projectOverview };