start_task
Activate a task as the current working task by specifying its ID, allowing time tracking and status updates.
Instructions
Starts the specified task and makes it the current task.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Task ID |
Implementation Reference
- src/sp-client.ts:249-253 (handler)The core API handler that sends a POST request to /tasks/{id}/start on the Super Productivity local REST API to start a task.
startTask(id: string): Promise<Task> { return request(`/tasks/${id}/start`, TaskSchema, { method: "POST", }); }, - src/tools/tasks.ts:227-227 (schema)Input schema for the start_task tool: expects a single string 'id' parameter for the task ID.
{ id: z.string().describe("Task ID") }, - src/tools/tasks.ts:224-232 (registration)Registration of the 'start_task' MCP tool via server.tool() with its description, input schema (id: string), and handler that calls SpClient.startTask(id).
server.tool( "start_task", "Starts the specified task and makes it the current task.", { id: z.string().describe("Task ID") }, async ({ id }) => { const task = await SpClient.startTask(id); return ok(task); } ); - src/index.ts:16-16 (registration)Top-level registration: registerTaskTools is called with the MCP server instance to register all task-related tools including start_task.
registerTaskTools(server);