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 +2 -2
- package/build/handlers/resource/tasksHandler.js +2 -0
- package/build/handlers/tool/createTaskHandler.js +5 -1
- package/build/handlers/tool/getTodayCalendarHandler.js +1 -0
- package/build/handlers/tool/getTodoListHandler.js +1 -0
- package/build/handlers/tool/updateTaskHandler.js +4 -1
- package/build/mcpServer.js +23 -6
- package/build/types/todo.js +1 -0
- package/package.json +1 -1
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
|
-
|
|
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
|
}
|
|
@@ -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
|
}
|
package/build/mcpServer.js
CHANGED
|
@@ -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:
|
|
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:
|
|
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:
|
|
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