@kaneo/mcp 0.1.8 → 0.1.10

package/README.md

@@ -4,7 +4,7 @@
 
 It runs over stdio, signs in with Kaneo's device flow, and then calls the Kaneo API with a bearer token. The package lives in `packages/mcp` in this monorepo and exposes the `kaneo-mcp` CLI.
 
-> **Tip:** Every Kaneo instance also ships a built-in HTTP MCP endpoint at `/api/mcp`. If your MCP client supports Streamable HTTP transport (e.g. Claude Code), you can connect directly without this package. See the [MCP docs](https://docs.kaneo.app/core/integrations/mcp) for details.
+> **Tip:** Every Kaneo instance also ships a built-in HTTP MCP endpoint at `/api/mcp`. If your MCP client supports Streamable HTTP transport (e.g. Claude Code), you can connect directly without this package. See the [MCP docs](https://kaneo.app/docs/core/integrations/mcp) for details.
 
 ## Prerequisites
 
@@ -115,13 +115,21 @@ For headless or sandboxed environments where opening a browser is impractical, s
 
 ## Tools
 
-- Session: `whoami`, `list_workspaces`
-- Projects: `list_projects`, `get_project`, `create_project`, `update_project`
-- Tasks: `list_tasks`, `get_task`, `create_task`, `update_task`, `move_task`, `update_task_status`
+- Session: `whoami`, `list_workspaces`, `list_workspace_members`, `list_notifications`
+- Search: `search`
+- Projects: `list_projects`, `get_project`, `create_project`, `update_project`, `list_project_columns`
+- Tasks: `list_tasks`, `get_task`, `create_task`, `update_task`, `delete_task`, `move_task`, `update_task_status`, `update_task_assignee`, `update_task_due_date`, `list_task_activity`
+- Time entries: `list_task_time_entries`, `get_time_entry`, `create_time_entry`, `update_time_entry`
 - Comments: `list_task_comments`, `create_task_comment`, `update_task_comment`, `delete_task_comment`
 - Labels: `list_workspace_labels`, `create_label`, `attach_label_to_task`, `detach_label_from_task`, `delete_label`
 - Task relations: `create_task_relation`, `get_task_relations`, `delete_task_relation`
 
+Call `list_project_columns` before setting a status: the column slugs it
+returns are the values `create_task` and `update_task_status` accept.
+`list_workspace_members` resolves the user IDs the assignee tools expect.
+Time entries have no delete endpoint on the API, so there is no
+`delete_time_entry` tool.
+
 ## Releasing
 
 Bump `version` in `packages/mcp/package.json` and merge to `main`. The [publish workflow](../../.github/workflows/publish-mcp.yml) runs the package tests, publishes the new version to npm, and creates a `mcp-v<version>` GitHub release. Nothing is published while the version stays the same, so tool changes reach npm only once the version is bumped.

package/dist/tools/register.js

@@ -347,4 +347,126 @@ export function registerTools(server, ctx) {
             method: "DELETE",
         });
     }));
+    server.registerTool("list_workspace_members", {
+        description: "List the members of a workspace. Use this to resolve the user ID an assignee tool expects.",
+        inputSchema: z.object({ workspaceId: nonEmptyString }),
+    }, async (args) => run(() => client.json(`/api/workspace/${encodeURIComponent(args.workspaceId)}/members`)));
+    server.registerTool("search", {
+        description: "Search across tasks, projects, workspaces, comments, and activities.",
+        inputSchema: z.object({
+            q: nonEmptyString.describe("Search query"),
+            type: z
+                .enum([
+                "all",
+                "tasks",
+                "projects",
+                "workspaces",
+                "comments",
+                "activities",
+            ])
+                .optional()
+                .describe("Restrict results to one kind. Defaults to all."),
+            workspaceId: optionalNonEmptyString.describe("Limit to one workspace"),
+            projectId: optionalNonEmptyString.describe("Limit to one project"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .optional()
+                .describe("Maximum results, 1 to 50. Defaults to 20."),
+        }),
+    }, async (args) => {
+        const qs = new URLSearchParams({ q: args.q });
+        if (args.type)
+            qs.set("type", args.type);
+        if (args.workspaceId)
+            qs.set("workspaceId", args.workspaceId);
+        if (args.projectId)
+            qs.set("projectId", args.projectId);
+        if (args.limit !== undefined)
+            qs.set("limit", String(args.limit));
+        return run(() => client.json(`/api/search?${qs.toString()}`));
+    });
+    server.registerTool("list_project_columns", {
+        description: "List a project's columns. Their slugs are the values update_task_status and create_task accept as a status.",
+        inputSchema: z.object({ projectId: nonEmptyString }),
+    }, async (args) => run(() => client.json(`/api/column/${encodeURIComponent(args.projectId)}`)));
+    server.registerTool("delete_task", {
+        description: "Delete a task by ID.",
+        inputSchema: z.object({ taskId: nonEmptyString }),
+    }, async (args) => run(() => client.json(`/api/task/${encodeURIComponent(args.taskId)}`, {
+        method: "DELETE",
+    })));
+    server.registerTool("update_task_assignee", {
+        description: "Assign a task to a workspace member, or pass a null userId to unassign it.",
+        inputSchema: z.object({
+            taskId: nonEmptyString,
+            userId: nonEmptyString
+                .nullable()
+                .describe("Member user ID, or null to unassign"),
+        }),
+    }, async (args) => run(() => client.json(`/api/task/assignee/${encodeURIComponent(args.taskId)}`, {
+        method: "PUT",
+        body: JSON.stringify({ userId: args.userId }),
+    })));
+    server.registerTool("update_task_due_date", {
+        description: "Set a task's due date. Omit dueDate to clear it.",
+        inputSchema: z.object({
+            taskId: nonEmptyString,
+            dueDate: optionalIsoDateTimeSchema,
+        }),
+    }, async (args) => run(() => client.json(`/api/task/due-date/${encodeURIComponent(args.taskId)}`, {
+        method: "PUT",
+        body: JSON.stringify(args.dueDate === undefined ? {} : { dueDate: args.dueDate }),
+    })));
+    server.registerTool("list_task_time_entries", {
+        description: "List the time entries logged against a task.",
+        inputSchema: z.object({ taskId: nonEmptyString }),
+    }, async (args) => run(() => client.json(`/api/time-entry/task/${encodeURIComponent(args.taskId)}`)));
+    server.registerTool("get_time_entry", {
+        description: "Get a single time entry by ID.",
+        inputSchema: z.object({ id: nonEmptyString }),
+    }, async (args) => run(() => client.json(`/api/time-entry/${encodeURIComponent(args.id)}`)));
+    server.registerTool("create_time_entry", {
+        description: "Log time against a task. Omit endTime to leave the entry running.",
+        inputSchema: z.object({
+            taskId: nonEmptyString,
+            startTime: isoDateTimeSchema,
+            endTime: optionalIsoDateTimeSchema,
+            description: optionalNonEmptyString,
+        }),
+    }, async (args) => run(() => client.json("/api/time-entry", {
+        method: "POST",
+        body: JSON.stringify({
+            taskId: args.taskId,
+            startTime: args.startTime,
+            ...(args.endTime ? { endTime: args.endTime } : {}),
+            ...(args.description ? { description: args.description } : {}),
+        }),
+    })));
+    server.registerTool("update_time_entry", {
+        description: "Update a time entry. startTime is required; omit endTime to reopen the entry.",
+        inputSchema: z.object({
+            id: nonEmptyString,
+            startTime: isoDateTimeSchema,
+            endTime: optionalIsoDateTimeSchema,
+            description: optionalNonEmptyString,
+        }),
+    }, async (args) => run(() => client.json(`/api/time-entry/${encodeURIComponent(args.id)}`, {
+        method: "PUT",
+        body: JSON.stringify({
+            startTime: args.startTime,
+            ...(args.endTime ? { endTime: args.endTime } : {}),
+            ...(args.description ? { description: args.description } : {}),
+        }),
+    })));
+    server.registerTool("list_task_activity", {
+        description: "List a task's activity history.",
+        inputSchema: z.object({ taskId: nonEmptyString }),
+    }, async (args) => run(() => client.json(`/api/activity/${encodeURIComponent(args.taskId)}`)));
+    server.registerTool("list_notifications", {
+        description: "List the signed-in user's notifications.",
+        inputSchema: z.object({}),
+    }, async () => run(() => client.json("/api/notification")));
 }

package/package.json

@@ -1,11 +1,11 @@
 {
 	"name": "@kaneo/mcp",
-	"version": "0.1.8",
+	"version": "0.1.10",
 	"mcpName": "io.github.usekaneo/kaneo",
 	"description": "Official MCP (Model Context Protocol) server for Kaneo, the open source project management platform: manage tasks, projects, and labels from Claude, Cursor, and other MCP clients",
 	"license": "MIT",
 	"author": "Kaneo (https://kaneo.app)",
-	"homepage": "https://docs.kaneo.app/core/integrations/mcp",
+	"homepage": "https://kaneo.app/docs/core/integrations/mcp",
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/usekaneo/kaneo/",
@@ -52,17 +52,17 @@
 		"test:watch": "vitest --config vitest.config.ts"
 	},
 	"dependencies": {
-		"@modelcontextprotocol/sdk": "^1.29.0",
+		"@modelcontextprotocol/sdk": "^1.30.0",
 		"open": "^11.0.0",
 		"prompts": "^2.4.2",
 		"zod": "^4.4.3"
 	},
 	"devDependencies": {
 		"@kaneo/typescript-config": "workspace:*",
-		"@types/node": "^25.3.5",
+		"@types/node": "^26.1.2",
 		"@types/prompts": "^2.4.9",
-		"tsx": "^4.23.1",
-		"typescript": "^5.9.3",
+		"tsx": "^4.23.9",
+		"typescript": "^7.0.2",
 		"vitest": "^4.1.10"
 	}
 }