togello-mcp-server 1.0.38 → 1.0.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -63,7 +63,7 @@ For OpenAI Apps domain verification, set `TOGELLO_MCP_OPENAI_APPS_CHALLENGE_TOKE
63
63
 
64
64
  All tools set MCP `readOnlyHint`, `openWorldHint`, and `destructiveHint` annotations explicitly. Read-only tools return stable JSON in both `structuredContent` and text content.
65
65
 
66
- - `get-tasks-list`: Retrieves incomplete TODO tasks. Optional `categoryUUIDs` filters by category UUID.
66
+ - `get-tasks-list`: Retrieves TODO tasks. By default it retrieves incomplete tasks. Optional `categoryUUIDs` filters by category UUID. Use `completionStatus: "COMPLETED"` with `completedStartDate` and `completedEndDate` in RFC3339 format to retrieve tasks completed during a period.
67
67
  - `get-calendar-date-memo`: Retrieves a calendar date memo for a `YYYY-MM-DD` date.
68
68
  - `get-todo-category-list`: Retrieves TODO categories.
69
69
  - `get-today-calendar`: Retrieves linked Google Calendar events and scheduled tasks.
@@ -1,11 +1,21 @@
1
1
  import { httpClient } from '../../client.js';
2
2
  import { errorToolResponse, jsonToolResponse } from './toolResponse.js';
3
- export const getTodoListHandler = async ({ categoryUUIDs, }) => {
3
+ export const getTodoListHandler = async ({ categoryUUIDs, completionStatus, completedStartDate, completedEndDate, }) => {
4
4
  try {
5
- const categoryUUIDArray = categoryUUIDs ?? [];
6
- const qs = categoryUUIDArray.length > 0
7
- ? `?${categoryUUIDArray.map((u) => `categoryUUID=${encodeURIComponent(u)}`).join('&')}`
8
- : '';
5
+ const searchParams = new URLSearchParams();
6
+ for (const categoryUUID of categoryUUIDs ?? []) {
7
+ searchParams.append('categoryUUID', categoryUUID);
8
+ }
9
+ if (completionStatus) {
10
+ searchParams.set('status', completionStatus);
11
+ }
12
+ if (completedStartDate) {
13
+ searchParams.set('completedStartDate', completedStartDate);
14
+ }
15
+ if (completedEndDate) {
16
+ searchParams.set('completedEndDate', completedEndDate);
17
+ }
18
+ const qs = searchParams.size > 0 ? `?${searchParams.toString()}` : '';
9
19
  const tasks = await httpClient.fetchURL({
10
20
  path: `/v2/integration/todo${qs}`,
11
21
  });
@@ -15,6 +25,7 @@ export const getTodoListHandler = async ({ categoryUUIDs, }) => {
15
25
  label: todo.label,
16
26
  status: todo.status,
17
27
  detail: todo.detail,
28
+ completedAt: todo.completedAt,
18
29
  scheduledStartDate: todo.scheduledStartDate,
19
30
  scheduledEndDate: todo.scheduledEndDate,
20
31
  deadlineDateTime: todo.deadlineDateTime,
@@ -23,7 +34,7 @@ export const getTodoListHandler = async ({ categoryUUIDs, }) => {
23
34
  categoryLabel: todo.categoryLabel,
24
35
  url: todo.url,
25
36
  })),
26
- guidance: 'The tasks with scheduled start dates that are today or in the past, and those with a priority of 2, should be addressed as soon as possible.',
37
+ guidance: 'Use completionStatus COMPLETED with completedStartDate and completedEndDate in RFC3339 format to retrieve tasks completed during a period such as yesterday. Tasks with scheduled start dates that are today or in the past, and those with a priority of 2, should be addressed as soon as possible.',
27
38
  });
28
39
  }
29
40
  catch (error) {
@@ -55,12 +55,24 @@ export function createMcpServer(options = {}) {
55
55
  },
56
56
  });
57
57
  server.registerTool('get-tasks-list', {
58
- description: 'Retrieves incomplete tasks from the TODO feature. Recognizes task uuid / task name / status / detail / scheduled start date and time / scheduled end date and time / deadline date and time / priority / category',
58
+ description: 'Retrieves tasks from the TODO feature. By default it returns incomplete tasks. For tasks completed yesterday or during another period, set completionStatus to COMPLETED and pass completedStartDate and completedEndDate as RFC3339 date-times. Recognizes task uuid / task name / status / detail / completed date and time / scheduled start date and time / scheduled end date and time / deadline date and time / priority / category',
59
59
  inputSchema: {
60
60
  categoryUUIDs: z
61
61
  .array(z.string())
62
62
  .optional()
63
63
  .describe('Filters tasks by specified category UUIDs.'),
64
+ completionStatus: z
65
+ .enum(['INCOMPLETE', 'COMPLETED'])
66
+ .optional()
67
+ .describe('Filters tasks by completion state. Omit this to retrieve incomplete tasks by default. Use COMPLETED for completed tasks.'),
68
+ completedStartDate: z
69
+ .string()
70
+ .optional()
71
+ .describe('Inclusive completed-at range start in RFC3339 format, for example yesterday at 00:00:00+09:00.'),
72
+ completedEndDate: z
73
+ .string()
74
+ .optional()
75
+ .describe('Exclusive completed-at range end in RFC3339 format, for example today at 00:00:00+09:00 when retrieving yesterday.'),
64
76
  },
65
77
  annotations: readOnlyToolAnnotations,
66
78
  }, withUpstreamToken(getTodoListHandler, options.resolveUpstreamToken, options.requireUpstreamToken));
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "type": "module",
3
3
  "name": "togello-mcp-server",
4
- "version": "1.0.38",
4
+ "version": "1.0.39",
5
5
  "description": "MCP server for Togello tasks, calendar memos, calendar events, and activity logs.",
6
6
  "main": "build/index.js",
7
7
  "scripts": {