togello-mcp-server 1.0.35 → 1.0.37

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
@@ -61,7 +61,7 @@ For OpenAI Apps domain verification, set `TOGELLO_MCP_OPENAI_APPS_CHALLENGE_TOKE
61
61
 
62
62
  ## Tools
63
63
 
64
- Read-only tools include MCP `readOnlyHint` annotations and return stable JSON in both `structuredContent` and text content.
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
66
  - `get-tasks-list`: Retrieves incomplete TODO tasks. Optional `categoryUUIDs` filters by category UUID.
67
67
  - `get-calendar-date-memo`: Retrieves a calendar date memo for a `YYYY-MM-DD` date.
@@ -71,7 +71,7 @@ Read-only tools include MCP `readOnlyHint` annotations and return stable JSON in
71
71
  - `get-activity-log-list`: Retrieves activity logs.
72
72
  - `get-japan-current-time`: Returns the current time in Japan.
73
73
 
74
- Write tools return JSON. Failed tool responses also return JSON and are marked with `isError: true`.
74
+ Write tools return JSON. Failed tool responses also return JSON and are marked with `isError: true`. Tools that can overwrite existing private Togello data set `destructiveHint: true`; create/start tools set `destructiveHint: false`.
75
75
 
76
76
  - `create-task`: Creates a TODO task.
77
77
  - `update-task`: Updates a TODO task.
@@ -12,8 +12,10 @@ export const tasksHandler = async (uri, _options) => {
12
12
  text: tasks
13
13
  .map((todo) => JSON.stringify({
14
14
  label: todo.label,
15
+ status: todo.status,
15
16
  scheduledStartDate: todo.scheduledStartDate,
16
17
  scheduledEndDate: todo.scheduledEndDate,
18
+ deadlineDateTime: todo.deadlineDateTime,
17
19
  priorityNumber: todo.priorityNumber,
18
20
  }))
19
21
  .join(','),
@@ -1,20 +1,24 @@
1
1
  import { httpClient } from '../../client.js';
2
2
  import { errorToolResponse, jsonToolResponse } from './toolResponse.js';
3
- export const createTaskHandler = async ({ taskName, categoryUUID, scheduledStartDate, scheduledEndDate, url, detail, }) => {
3
+ export const createTaskHandler = async ({ taskName, status, categoryUUID, scheduledStartDate, scheduledEndDate, deadlineDateTime, url, detail, }) => {
4
4
  try {
5
5
  await httpClient.postJson({
6
6
  path: '/v2/integration/todo',
7
7
  body: {
8
8
  label: taskName,
9
+ status: status,
9
10
  categoryUUID: categoryUUID,
10
11
  scheduledStartDate: scheduledStartDate,
11
12
  scheduledEndDate: scheduledEndDate,
13
+ deadlineDateTime: deadlineDateTime,
12
14
  url: url,
13
15
  detail: detail,
14
16
  },
15
17
  });
16
18
  return jsonToolResponse({
17
19
  taskName,
20
+ status,
21
+ deadlineDateTime,
18
22
  created: true,
19
23
  });
20
24
  }
@@ -19,6 +19,7 @@ export const getTodayCalendarHandler = async () => {
19
19
  taskName: task.label,
20
20
  scheduledStartDate: task.scheduledStartDate,
21
21
  scheduledEndDate: task.scheduledEndDate,
22
+ deadlineDateTime: task.deadlineDateTime,
22
23
  })),
23
24
  });
24
25
  }
@@ -17,6 +17,7 @@ export const getTodoListHandler = async ({ categoryUUIDs, }) => {
17
17
  detail: todo.detail,
18
18
  scheduledStartDate: todo.scheduledStartDate,
19
19
  scheduledEndDate: todo.scheduledEndDate,
20
+ deadlineDateTime: todo.deadlineDateTime,
20
21
  priorityNumber: todo.priorityNumber,
21
22
  categoryUUID: todo.categoryUUID,
22
23
  categoryLabel: todo.categoryLabel,
@@ -1,12 +1,13 @@
1
1
  import { httpClient } from '../../client.js';
2
2
  import { errorToolResponse, jsonToolResponse } from './toolResponse.js';
3
- export const updateTaskHandler = async ({ todoUUID, taskName, isCompleted, status, scheduledStartDate, scheduledEndDate, url, detail, }) => {
3
+ export const updateTaskHandler = async ({ todoUUID, taskName, isCompleted, status, scheduledStartDate, scheduledEndDate, deadlineDateTime, url, detail, }) => {
4
4
  try {
5
5
  if (taskName === undefined &&
6
6
  isCompleted === undefined &&
7
7
  status === undefined &&
8
8
  scheduledStartDate === undefined &&
9
9
  scheduledEndDate === undefined &&
10
+ deadlineDateTime === undefined &&
10
11
  url === undefined &&
11
12
  detail === undefined) {
12
13
  return errorToolResponse('At least one update field is required');
@@ -22,6 +23,7 @@ export const updateTaskHandler = async ({ todoUUID, taskName, isCompleted, statu
22
23
  status,
23
24
  scheduledStartDate,
24
25
  scheduledEndDate,
26
+ deadlineDateTime,
25
27
  url,
26
28
  detail,
27
29
  },
@@ -31,6 +33,7 @@ export const updateTaskHandler = async ({ todoUUID, taskName, isCompleted, statu
31
33
  taskName,
32
34
  isCompleted,
33
35
  status,
36
+ deadlineDateTime,
34
37
  updated: true,
35
38
  });
36
39
  }
@@ -27,6 +27,11 @@ const privateWriteToolAnnotations = {
27
27
  openWorldHint: false,
28
28
  destructiveHint: false,
29
29
  };
30
+ const privateOverwriteToolAnnotations = {
31
+ readOnlyHint: false,
32
+ openWorldHint: false,
33
+ destructiveHint: true,
34
+ };
30
35
  function withUpstreamToken(cb, resolveUpstreamToken, requireUpstreamToken = false) {
31
36
  return async (args, extra) => {
32
37
  const token = resolveUpstreamToken?.(extra.sessionId);
@@ -50,7 +55,7 @@ export function createMcpServer(options = {}) {
50
55
  },
51
56
  });
52
57
  server.registerTool('get-tasks-list', {
53
- 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 / priority / category',
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',
54
59
  inputSchema: {
55
60
  categoryUUIDs: z
56
61
  .array(z.string())
@@ -63,6 +68,10 @@ export function createMcpServer(options = {}) {
63
68
  description: 'Creates a new task in the TODO feature.',
64
69
  inputSchema: {
65
70
  taskName: z.string().describe('create task name'),
71
+ status: z
72
+ .enum(['TODO', 'PENDING', 'DOING', 'DONE'])
73
+ .optional()
74
+ .describe('Optional. Creates the task with the specified todo status.'),
66
75
  categoryUUID: z
67
76
  .string()
68
77
  .optional()
@@ -75,6 +84,10 @@ export function createMcpServer(options = {}) {
75
84
  .string()
76
85
  .optional()
77
86
  .describe('Scheduled end date in ISO format.'),
87
+ deadlineDateTime: z
88
+ .string()
89
+ .optional()
90
+ .describe('Deadline date and time in ISO format.'),
78
91
  url: z
79
92
  .string()
80
93
  .optional()
@@ -102,9 +115,9 @@ export function createMcpServer(options = {}) {
102
115
  .optional()
103
116
  .describe('Optional. Backward-compatible completion update. true marks the task done. false preserves existing TODO or DOING tasks and reopens DONE tasks to TODO.'),
104
117
  status: z
105
- .enum(['TODO', 'DOING', 'DONE'])
118
+ .enum(['TODO', 'PENDING', 'DOING', 'DONE'])
106
119
  .optional()
107
- .describe('Optional. Updates the todo status directly. Use this to switch tasks between TODO, DOING, and DONE.'),
120
+ .describe('Optional. Updates the todo status directly. Use this to switch tasks between TODO, PENDING, DOING, and DONE.'),
108
121
  scheduledStartDate: z
109
122
  .string()
110
123
  .optional()
@@ -113,6 +126,10 @@ export function createMcpServer(options = {}) {
113
126
  .string()
114
127
  .optional()
115
128
  .describe('Scheduled end date in ISO format. If omitted, the current value is kept.'),
129
+ deadlineDateTime: z
130
+ .string()
131
+ .optional()
132
+ .describe('Deadline date and time in ISO format. If omitted, the current value is kept.'),
116
133
  url: z
117
134
  .string()
118
135
  .optional()
@@ -122,7 +139,7 @@ export function createMcpServer(options = {}) {
122
139
  .optional()
123
140
  .describe('Optional detail associated with the task. If omitted, the current value is kept.'),
124
141
  },
125
- annotations: privateWriteToolAnnotations,
142
+ annotations: privateOverwriteToolAnnotations,
126
143
  }, withUpstreamToken(updateTaskHandler, options.resolveUpstreamToken, options.requireUpstreamToken));
127
144
  server.registerTool('get-calendar-date-memo', {
128
145
  description: 'Retrieves a calendar date memo for the specified date. Recognizes target date and memo content.',
@@ -139,7 +156,7 @@ export function createMcpServer(options = {}) {
139
156
  .string()
140
157
  .describe('Memo content for the date. Pass an empty or whitespace-only string to clear the memo.'),
141
158
  },
142
- annotations: privateWriteToolAnnotations,
159
+ annotations: privateOverwriteToolAnnotations,
143
160
  }, withUpstreamToken(updateCalendarDateMemoHandler, options.resolveUpstreamToken, options.requireUpstreamToken));
144
161
  server.registerTool('get-todo-category-list', {
145
162
  description: 'Retrieves the list of categories from the TODO feature. Recognizes category name / category UUID',
@@ -178,7 +195,7 @@ export function createMcpServer(options = {}) {
178
195
  .uuid()
179
196
  .describe('You must specify a valid activityLogUUID obtained from get-activity-log-list. This tool requires an existing activity log.'),
180
197
  },
181
- annotations: privateWriteToolAnnotations,
198
+ annotations: privateOverwriteToolAnnotations,
182
199
  }, withUpstreamToken(completeActivityLogHandler, options.resolveUpstreamToken, options.requireUpstreamToken));
183
200
  server.registerTool('get-japan-current-time', {
184
201
  description: 'Returns the current time in Japan (JST).',
@@ -0,0 +1 @@
1
+ export {};
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "type": "module",
3
3
  "name": "togello-mcp-server",
4
- "version": "1.0.35",
4
+ "version": "1.0.37",
5
5
  "description": "MCP server for Togello tasks, calendar memos, calendar events, and activity logs.",
6
6
  "main": "build/index.js",
7
7
  "scripts": {