cortexaforge-clickup-mcp 0.1.0
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/LICENSE +21 -0
- package/README.md +71 -0
- package/dist/clickup/client.d.ts +21 -0
- package/dist/clickup/client.js +81 -0
- package/dist/clickup/client.js.map +1 -0
- package/dist/clickup/resolver.d.ts +33 -0
- package/dist/clickup/resolver.js +154 -0
- package/dist/clickup/resolver.js.map +1 -0
- package/dist/clickup/types.d.ts +140 -0
- package/dist/clickup/types.js +2 -0
- package/dist/clickup/types.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.js +98 -0
- package/dist/index.js.map +1 -0
- package/dist/server.d.ts +6 -0
- package/dist/server.js +23 -0
- package/dist/server.js.map +1 -0
- package/dist/tools/comments.d.ts +4 -0
- package/dist/tools/comments.js +38 -0
- package/dist/tools/comments.js.map +1 -0
- package/dist/tools/docs.d.ts +4 -0
- package/dist/tools/docs.js +78 -0
- package/dist/tools/docs.js.map +1 -0
- package/dist/tools/tasks.d.ts +4 -0
- package/dist/tools/tasks.js +171 -0
- package/dist/tools/tasks.js.map +1 -0
- package/dist/tools/time.d.ts +4 -0
- package/dist/tools/time.js +95 -0
- package/dist/tools/time.js.map +1 -0
- package/dist/tools/workspace.d.ts +4 -0
- package/dist/tools/workspace.js +35 -0
- package/dist/tools/workspace.js.map +1 -0
- package/dist/utils/errors.d.ts +8 -0
- package/dist/utils/errors.js +17 -0
- package/dist/utils/errors.js.map +1 -0
- package/dist/utils/logger.d.ts +6 -0
- package/dist/utils/logger.js +20 -0
- package/dist/utils/logger.js.map +1 -0
- package/package.json +55 -0
package/dist/server.js
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import { ClickUpClient } from "./clickup/client.js";
|
|
3
|
+
import { Resolver } from "./clickup/resolver.js";
|
|
4
|
+
import { registerWorkspaceTools } from "./tools/workspace.js";
|
|
5
|
+
import { registerTaskTools } from "./tools/tasks.js";
|
|
6
|
+
import { registerCommentTools } from "./tools/comments.js";
|
|
7
|
+
import { registerTimeTools } from "./tools/time.js";
|
|
8
|
+
import { registerDocTools } from "./tools/docs.js";
|
|
9
|
+
export function buildServer(opts) {
|
|
10
|
+
const client = new ClickUpClient({ apiKey: opts.apiKey, teamId: opts.teamId });
|
|
11
|
+
const resolver = new Resolver(client);
|
|
12
|
+
const server = new McpServer({
|
|
13
|
+
name: "cortexaforge-clickup-mcp",
|
|
14
|
+
version: "0.1.0",
|
|
15
|
+
});
|
|
16
|
+
registerWorkspaceTools(server, client, resolver);
|
|
17
|
+
registerTaskTools(server, client, resolver);
|
|
18
|
+
registerCommentTools(server, client, resolver);
|
|
19
|
+
registerTimeTools(server, client, resolver);
|
|
20
|
+
registerDocTools(server, client, resolver);
|
|
21
|
+
return server;
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOnD,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEtC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,0BAA0B;QAChC,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjD,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5C,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC/C,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5C,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAE3C,OAAO,MAAM,CAAC;AAChB,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import { ClickUpClient } from "../clickup/client.js";
|
|
3
|
+
import { Resolver } from "../clickup/resolver.js";
|
|
4
|
+
export declare function registerCommentTools(server: McpServer, client: ClickUpClient, resolver: Resolver): void;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export function registerCommentTools(server, client, resolver) {
|
|
3
|
+
server.registerTool("get_task_comments", {
|
|
4
|
+
title: "Get task comments",
|
|
5
|
+
description: "Fetch comments on a task. Provide task_id or task_name.",
|
|
6
|
+
inputSchema: {
|
|
7
|
+
task_id: z.string().optional(),
|
|
8
|
+
task_name: z.string().optional(),
|
|
9
|
+
list_id: z.string().optional(),
|
|
10
|
+
list_name: z.string().optional(),
|
|
11
|
+
},
|
|
12
|
+
}, async (a) => {
|
|
13
|
+
const task_id = await resolver.resolveTaskId(a);
|
|
14
|
+
const res = await client.get(2, `/task/${task_id}/comment`);
|
|
15
|
+
return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
|
|
16
|
+
});
|
|
17
|
+
server.registerTool("create_task_comment", {
|
|
18
|
+
title: "Post a comment on a task",
|
|
19
|
+
description: "Add a new comment on a task. Provide task_id or task_name.",
|
|
20
|
+
inputSchema: {
|
|
21
|
+
task_id: z.string().optional(),
|
|
22
|
+
task_name: z.string().optional(),
|
|
23
|
+
list_id: z.string().optional(),
|
|
24
|
+
list_name: z.string().optional(),
|
|
25
|
+
comment_text: z.string(),
|
|
26
|
+
notify_all: z.boolean().optional().default(false),
|
|
27
|
+
assignee: z.number().int().optional().describe("User ID to assign the comment to"),
|
|
28
|
+
},
|
|
29
|
+
}, async (a) => {
|
|
30
|
+
const task_id = await resolver.resolveTaskId(a);
|
|
31
|
+
const body = { comment_text: a.comment_text, notify_all: a.notify_all };
|
|
32
|
+
if (a.assignee)
|
|
33
|
+
body.assignee = a.assignee;
|
|
34
|
+
const res = await client.post(2, `/task/${task_id}/comment`, body);
|
|
35
|
+
return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
|
|
36
|
+
});
|
|
37
|
+
}
|
|
38
|
+
//# sourceMappingURL=comments.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"comments.js","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,MAAqB,EAAE,QAAkB;IAC/F,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,yDAAyD;QACtE,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACjC;KACF,EACD,KAAK,EAAE,CAAC,EAAE,EAAE;QACV,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAA0B,CAAC,EAAE,SAAS,OAAO,UAAU,CAAC,CAAC;QACrF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,4DAA4D;QACzE,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;YACxB,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;YACjD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;SACnF;KACF,EACD,KAAK,EAAE,CAAC,EAAE,EAAE;QACV,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,IAAI,GAA4B,EAAE,YAAY,EAAE,CAAC,CAAC,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;QACjG,IAAI,CAAC,CAAC,QAAQ;YAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAU,CAAC,EAAE,SAAS,OAAO,UAAU,EAAE,IAAI,CAAC,CAAC;QAC5E,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7E,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import { ClickUpClient } from "../clickup/client.js";
|
|
3
|
+
import { Resolver } from "../clickup/resolver.js";
|
|
4
|
+
export declare function registerDocTools(server: McpServer, client: ClickUpClient, _resolver: Resolver): void;
|
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export function registerDocTools(server, client, _resolver) {
|
|
3
|
+
server.registerTool("list_docs", {
|
|
4
|
+
title: "List ClickUp Docs",
|
|
5
|
+
description: "List Docs in the active workspace. Use to discover doc IDs.",
|
|
6
|
+
inputSchema: {
|
|
7
|
+
limit: z.number().int().min(1).max(100).optional().default(50),
|
|
8
|
+
archived: z.boolean().optional().default(false),
|
|
9
|
+
},
|
|
10
|
+
}, async (a) => {
|
|
11
|
+
const res = await client.get(3, `/workspaces/${client.teamId}/docs`, {
|
|
12
|
+
limit: a.limit,
|
|
13
|
+
archived: a.archived,
|
|
14
|
+
deleted: false,
|
|
15
|
+
});
|
|
16
|
+
return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
|
|
17
|
+
});
|
|
18
|
+
server.registerTool("get_doc", {
|
|
19
|
+
title: "Get a Doc (all pages, joined as markdown)",
|
|
20
|
+
description: "Retrieve a Doc by ID, including all pages concatenated into a single markdown string.",
|
|
21
|
+
inputSchema: {
|
|
22
|
+
doc_id: z.string(),
|
|
23
|
+
},
|
|
24
|
+
}, async (a) => {
|
|
25
|
+
const doc = await client.get(3, `/workspaces/${client.teamId}/docs/${a.doc_id}`);
|
|
26
|
+
const pages = await client.get(3, `/workspaces/${client.teamId}/docs/${a.doc_id}/pages`, {
|
|
27
|
+
max_page_depth: -1,
|
|
28
|
+
content_format: "text/md",
|
|
29
|
+
});
|
|
30
|
+
const markdown = pages.map((p) => `# ${p.name}\n\n${p.content ?? ""}`).join("\n\n---\n\n");
|
|
31
|
+
return {
|
|
32
|
+
content: [{ type: "text", text: JSON.stringify({ doc, page_count: pages.length, markdown }, null, 2) }],
|
|
33
|
+
};
|
|
34
|
+
});
|
|
35
|
+
server.registerTool("create_doc", {
|
|
36
|
+
title: "Create a Doc",
|
|
37
|
+
description: "Create a new ClickUp Doc under a space/folder/list.",
|
|
38
|
+
inputSchema: {
|
|
39
|
+
name: z.string(),
|
|
40
|
+
parent_id: z.string().describe("ID of the parent (space/folder/list)"),
|
|
41
|
+
parent_type: z
|
|
42
|
+
.union([z.literal(4), z.literal(5), z.literal(6), z.literal(7), z.literal(12)])
|
|
43
|
+
.describe("4=space, 5=folder, 6=list, 7=everything, 12=workspace"),
|
|
44
|
+
visibility: z.enum(["PUBLIC", "PRIVATE"]).optional().default("PRIVATE"),
|
|
45
|
+
create_page: z.boolean().optional().default(true),
|
|
46
|
+
},
|
|
47
|
+
}, async (a) => {
|
|
48
|
+
const body = {
|
|
49
|
+
name: a.name,
|
|
50
|
+
parent: { id: a.parent_id, type: a.parent_type },
|
|
51
|
+
visibility: a.visibility,
|
|
52
|
+
create_page: a.create_page,
|
|
53
|
+
};
|
|
54
|
+
const res = await client.post(3, `/workspaces/${client.teamId}/docs`, body);
|
|
55
|
+
return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
|
|
56
|
+
});
|
|
57
|
+
server.registerTool("append_to_doc", {
|
|
58
|
+
title: "Append a markdown page to a Doc",
|
|
59
|
+
description: "Add a new page (markdown content) to an existing Doc. Optionally nest under a parent page.",
|
|
60
|
+
inputSchema: {
|
|
61
|
+
doc_id: z.string(),
|
|
62
|
+
page_name: z.string(),
|
|
63
|
+
markdown_content: z.string(),
|
|
64
|
+
parent_page_id: z.string().optional().describe("If provided, creates as a sub-page of this page"),
|
|
65
|
+
},
|
|
66
|
+
}, async (a) => {
|
|
67
|
+
const body = {
|
|
68
|
+
name: a.page_name,
|
|
69
|
+
content: a.markdown_content,
|
|
70
|
+
content_format: "text/md",
|
|
71
|
+
};
|
|
72
|
+
if (a.parent_page_id)
|
|
73
|
+
body.parent_page_id = a.parent_page_id;
|
|
74
|
+
const res = await client.post(3, `/workspaces/${client.teamId}/docs/${a.doc_id}/pages`, body);
|
|
75
|
+
return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
|
|
76
|
+
});
|
|
77
|
+
}
|
|
78
|
+
//# sourceMappingURL=docs.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/tools/docs.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import { ClickUpClient } from "../clickup/client.js";
|
|
3
|
+
import { Resolver } from "../clickup/resolver.js";
|
|
4
|
+
export declare function registerTaskTools(server: McpServer, client: ClickUpClient, resolver: Resolver): void;
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
const ID_OR_NAME = "Provide either the ID or the name.";
|
|
3
|
+
export function registerTaskTools(server, client, resolver) {
|
|
4
|
+
server.registerTool("list_tasks", {
|
|
5
|
+
title: "List tasks in a list",
|
|
6
|
+
description: `Lists tasks within a specific ClickUp list. ${ID_OR_NAME}`,
|
|
7
|
+
inputSchema: {
|
|
8
|
+
list_id: z.string().optional(),
|
|
9
|
+
list_name: z.string().optional(),
|
|
10
|
+
include_closed: z.boolean().optional().default(false),
|
|
11
|
+
subtasks: z.boolean().optional().default(false),
|
|
12
|
+
page: z.number().int().min(0).optional().default(0),
|
|
13
|
+
},
|
|
14
|
+
}, async (a) => {
|
|
15
|
+
const list_id = await resolver.resolveListId({ list_id: a.list_id, list_name: a.list_name });
|
|
16
|
+
const res = await client.get(2, `/list/${list_id}/task`, {
|
|
17
|
+
include_closed: a.include_closed,
|
|
18
|
+
subtasks: a.subtasks,
|
|
19
|
+
page: a.page,
|
|
20
|
+
archived: false,
|
|
21
|
+
});
|
|
22
|
+
return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
|
|
23
|
+
});
|
|
24
|
+
server.registerTool("get_task", {
|
|
25
|
+
title: "Get a task",
|
|
26
|
+
description: `Fetch a single task by ID or name. ${ID_OR_NAME} Narrow with list_id/list_name if the name might collide.`,
|
|
27
|
+
inputSchema: {
|
|
28
|
+
task_id: z.string().optional(),
|
|
29
|
+
task_name: z.string().optional(),
|
|
30
|
+
list_id: z.string().optional(),
|
|
31
|
+
list_name: z.string().optional(),
|
|
32
|
+
},
|
|
33
|
+
}, async (a) => {
|
|
34
|
+
const task_id = await resolver.resolveTaskId(a);
|
|
35
|
+
const task = await client.get(2, `/task/${task_id}`);
|
|
36
|
+
return { content: [{ type: "text", text: JSON.stringify(task, null, 2) }] };
|
|
37
|
+
});
|
|
38
|
+
server.registerTool("create_task", {
|
|
39
|
+
title: "Create a task",
|
|
40
|
+
description: `Create a new task in a list. ${ID_OR_NAME} for the list. Priority is 1 (urgent) → 4 (low).`,
|
|
41
|
+
inputSchema: {
|
|
42
|
+
list_id: z.string().optional(),
|
|
43
|
+
list_name: z.string().optional(),
|
|
44
|
+
name: z.string(),
|
|
45
|
+
description: z.string().optional(),
|
|
46
|
+
markdown_description: z.string().optional(),
|
|
47
|
+
status: z.string().optional(),
|
|
48
|
+
priority: z.union([z.literal(1), z.literal(2), z.literal(3), z.literal(4)]).optional(),
|
|
49
|
+
due_date: z.number().int().optional().describe("Unix ms timestamp"),
|
|
50
|
+
assignees: z.array(z.number().int()).optional(),
|
|
51
|
+
tags: z.array(z.string()).optional(),
|
|
52
|
+
},
|
|
53
|
+
}, async (a) => {
|
|
54
|
+
const list_id = await resolver.resolveListId({ list_id: a.list_id, list_name: a.list_name });
|
|
55
|
+
const body = { name: a.name };
|
|
56
|
+
if (a.description)
|
|
57
|
+
body.description = a.description;
|
|
58
|
+
if (a.markdown_description)
|
|
59
|
+
body.markdown_description = a.markdown_description;
|
|
60
|
+
if (a.status)
|
|
61
|
+
body.status = a.status;
|
|
62
|
+
if (a.priority)
|
|
63
|
+
body.priority = a.priority;
|
|
64
|
+
if (a.due_date)
|
|
65
|
+
body.due_date = a.due_date;
|
|
66
|
+
if (a.assignees)
|
|
67
|
+
body.assignees = a.assignees;
|
|
68
|
+
if (a.tags)
|
|
69
|
+
body.tags = a.tags;
|
|
70
|
+
const task = await client.post(2, `/list/${list_id}/task`, body);
|
|
71
|
+
resolver.invalidate();
|
|
72
|
+
return { content: [{ type: "text", text: JSON.stringify(task, null, 2) }] };
|
|
73
|
+
});
|
|
74
|
+
server.registerTool("update_task", {
|
|
75
|
+
title: "Update a task",
|
|
76
|
+
description: `Update an existing task. ${ID_OR_NAME}`,
|
|
77
|
+
inputSchema: {
|
|
78
|
+
task_id: z.string().optional(),
|
|
79
|
+
task_name: z.string().optional(),
|
|
80
|
+
list_id: z.string().optional(),
|
|
81
|
+
list_name: z.string().optional(),
|
|
82
|
+
name: z.string().optional(),
|
|
83
|
+
description: z.string().optional(),
|
|
84
|
+
markdown_description: z.string().optional(),
|
|
85
|
+
status: z.string().optional(),
|
|
86
|
+
priority: z.union([z.literal(1), z.literal(2), z.literal(3), z.literal(4)]).nullable().optional(),
|
|
87
|
+
due_date: z.number().int().nullable().optional(),
|
|
88
|
+
add_assignees: z.array(z.number().int()).optional(),
|
|
89
|
+
remove_assignees: z.array(z.number().int()).optional(),
|
|
90
|
+
archived: z.boolean().optional(),
|
|
91
|
+
},
|
|
92
|
+
}, async (a) => {
|
|
93
|
+
const task_id = await resolver.resolveTaskId(a);
|
|
94
|
+
const body = {};
|
|
95
|
+
for (const k of ["name", "description", "markdown_description", "status", "priority", "due_date", "archived"]) {
|
|
96
|
+
const v = a[k];
|
|
97
|
+
if (v !== undefined)
|
|
98
|
+
body[k] = v;
|
|
99
|
+
}
|
|
100
|
+
if (a.add_assignees || a.remove_assignees) {
|
|
101
|
+
body.assignees = { add: a.add_assignees ?? [], rem: a.remove_assignees ?? [] };
|
|
102
|
+
}
|
|
103
|
+
const task = await client.put(2, `/task/${task_id}`, body);
|
|
104
|
+
return { content: [{ type: "text", text: JSON.stringify(task, null, 2) }] };
|
|
105
|
+
});
|
|
106
|
+
server.registerTool("delete_task", {
|
|
107
|
+
title: "Delete a task",
|
|
108
|
+
description: `Permanently delete a task. ${ID_OR_NAME}`,
|
|
109
|
+
inputSchema: {
|
|
110
|
+
task_id: z.string().optional(),
|
|
111
|
+
task_name: z.string().optional(),
|
|
112
|
+
list_id: z.string().optional(),
|
|
113
|
+
list_name: z.string().optional(),
|
|
114
|
+
},
|
|
115
|
+
}, async (a) => {
|
|
116
|
+
const task_id = await resolver.resolveTaskId(a);
|
|
117
|
+
await client.delete(2, `/task/${task_id}`);
|
|
118
|
+
resolver.invalidate();
|
|
119
|
+
return { content: [{ type: "text", text: `Deleted task ${task_id}` }] };
|
|
120
|
+
});
|
|
121
|
+
server.registerTool("search_tasks", {
|
|
122
|
+
title: "Search tasks across the workspace",
|
|
123
|
+
description: "Case-insensitive substring search over task names (and content) in the workspace. Narrow by space, list, status, or assignees.",
|
|
124
|
+
inputSchema: {
|
|
125
|
+
query: z.string().describe("Substring to match in task name or text content"),
|
|
126
|
+
space_id: z.string().optional(),
|
|
127
|
+
space_name: z.string().optional(),
|
|
128
|
+
list_id: z.string().optional(),
|
|
129
|
+
list_name: z.string().optional(),
|
|
130
|
+
statuses: z.array(z.string()).optional(),
|
|
131
|
+
assignees: z.array(z.number().int()).optional(),
|
|
132
|
+
include_closed: z.boolean().optional().default(false),
|
|
133
|
+
limit: z.number().int().min(1).max(100).optional().default(25),
|
|
134
|
+
},
|
|
135
|
+
}, async (a) => {
|
|
136
|
+
let allTasks = [];
|
|
137
|
+
if (a.list_id || a.list_name) {
|
|
138
|
+
const list_id = await resolver.resolveListId({ list_id: a.list_id, list_name: a.list_name });
|
|
139
|
+
const res = await client.get(2, `/list/${list_id}/task`, {
|
|
140
|
+
include_closed: a.include_closed,
|
|
141
|
+
subtasks: true,
|
|
142
|
+
page: 0,
|
|
143
|
+
archived: false,
|
|
144
|
+
});
|
|
145
|
+
allTasks = res.tasks;
|
|
146
|
+
}
|
|
147
|
+
else {
|
|
148
|
+
const res = await client.get(2, `/team/${client.teamId}/task`, {
|
|
149
|
+
include_closed: a.include_closed,
|
|
150
|
+
subtasks: true,
|
|
151
|
+
page: 0,
|
|
152
|
+
});
|
|
153
|
+
allTasks = res.tasks;
|
|
154
|
+
}
|
|
155
|
+
let scopedSpaceId;
|
|
156
|
+
if (a.space_id || a.space_name) {
|
|
157
|
+
scopedSpaceId = await resolver.resolveSpaceId({ space_id: a.space_id, space_name: a.space_name });
|
|
158
|
+
}
|
|
159
|
+
const q = a.query.toLowerCase();
|
|
160
|
+
const filtered = allTasks
|
|
161
|
+
.filter((t) => !scopedSpaceId || t.space?.id === scopedSpaceId)
|
|
162
|
+
.filter((t) => t.name.toLowerCase().includes(q) || (t.text_content ?? "").toLowerCase().includes(q))
|
|
163
|
+
.filter((t) => !a.statuses || a.statuses.includes(t.status.status))
|
|
164
|
+
.filter((t) => !a.assignees || (t.assignees ?? []).some((u) => a.assignees.includes(u.id)))
|
|
165
|
+
.slice(0, a.limit);
|
|
166
|
+
return {
|
|
167
|
+
content: [{ type: "text", text: JSON.stringify({ matched: filtered.length, tasks: filtered }, null, 2) }],
|
|
168
|
+
};
|
|
169
|
+
});
|
|
170
|
+
}
|
|
171
|
+
//# sourceMappingURL=tasks.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import { ClickUpClient } from "../clickup/client.js";
|
|
3
|
+
import { Resolver } from "../clickup/resolver.js";
|
|
4
|
+
export declare function registerTimeTools(server: McpServer, client: ClickUpClient, resolver: Resolver): void;
|
|
@@ -0,0 +1,95 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
export function registerTimeTools(server, client, resolver) {
|
|
3
|
+
server.registerTool("get_current_timer", {
|
|
4
|
+
title: "Get the currently running timer",
|
|
5
|
+
description: "Returns the running timer for the authenticated user, or null if no timer is running.",
|
|
6
|
+
inputSchema: {},
|
|
7
|
+
}, async () => {
|
|
8
|
+
const res = await client.get(2, `/team/${client.teamId}/time_entries/current`);
|
|
9
|
+
return { content: [{ type: "text", text: JSON.stringify(res?.data ?? null, null, 2) }] };
|
|
10
|
+
});
|
|
11
|
+
server.registerTool("start_timer", {
|
|
12
|
+
title: "Start a timer on a task",
|
|
13
|
+
description: "Start a running timer on a task. Provide task_id or task_name.",
|
|
14
|
+
inputSchema: {
|
|
15
|
+
task_id: z.string().optional(),
|
|
16
|
+
task_name: z.string().optional(),
|
|
17
|
+
list_id: z.string().optional(),
|
|
18
|
+
list_name: z.string().optional(),
|
|
19
|
+
description: z.string().optional(),
|
|
20
|
+
billable: z.boolean().optional(),
|
|
21
|
+
tags: z.array(z.string()).optional(),
|
|
22
|
+
},
|
|
23
|
+
}, async (a) => {
|
|
24
|
+
const task_id = await resolver.resolveTaskId(a);
|
|
25
|
+
const body = { tid: task_id };
|
|
26
|
+
if (a.description)
|
|
27
|
+
body.description = a.description;
|
|
28
|
+
if (a.billable !== undefined)
|
|
29
|
+
body.billable = a.billable;
|
|
30
|
+
if (a.tags)
|
|
31
|
+
body.tags = a.tags.map((name) => ({ name }));
|
|
32
|
+
const res = await client.post(2, `/team/${client.teamId}/time_entries/start`, body);
|
|
33
|
+
return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
|
|
34
|
+
});
|
|
35
|
+
server.registerTool("stop_timer", {
|
|
36
|
+
title: "Stop the currently running timer",
|
|
37
|
+
description: "Stops the user's active running timer.",
|
|
38
|
+
inputSchema: {},
|
|
39
|
+
}, async () => {
|
|
40
|
+
const res = await client.post(2, `/team/${client.teamId}/time_entries/stop`);
|
|
41
|
+
return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
|
|
42
|
+
});
|
|
43
|
+
server.registerTool("get_time_entries", {
|
|
44
|
+
title: "List time entries in a date range",
|
|
45
|
+
description: "Retrieve time entries in a date range. Defaults to the last 7 days.",
|
|
46
|
+
inputSchema: {
|
|
47
|
+
start_date_ms: z.number().int().optional().describe("Unix ms; defaults to 7 days ago"),
|
|
48
|
+
end_date_ms: z.number().int().optional().describe("Unix ms; defaults to now"),
|
|
49
|
+
task_id: z.string().optional(),
|
|
50
|
+
task_name: z.string().optional(),
|
|
51
|
+
list_id: z.string().optional(),
|
|
52
|
+
list_name: z.string().optional(),
|
|
53
|
+
},
|
|
54
|
+
}, async (a) => {
|
|
55
|
+
const end = a.end_date_ms ?? Date.now();
|
|
56
|
+
const start = a.start_date_ms ?? end - 7 * 24 * 60 * 60 * 1000;
|
|
57
|
+
const q = { start_date: start, end_date: end };
|
|
58
|
+
if (a.task_id || a.task_name) {
|
|
59
|
+
q.task_id = await resolver.resolveTaskId(a);
|
|
60
|
+
}
|
|
61
|
+
const res = await client.get(2, `/team/${client.teamId}/time_entries`, q);
|
|
62
|
+
return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
|
|
63
|
+
});
|
|
64
|
+
server.registerTool("log_manual_time", {
|
|
65
|
+
title: "Log time manually",
|
|
66
|
+
description: "Create a completed time entry on a task — for backfilling time tracked elsewhere.",
|
|
67
|
+
inputSchema: {
|
|
68
|
+
task_id: z.string().optional(),
|
|
69
|
+
task_name: z.string().optional(),
|
|
70
|
+
list_id: z.string().optional(),
|
|
71
|
+
list_name: z.string().optional(),
|
|
72
|
+
start_ms: z.number().int().describe("Unix ms when the entry started"),
|
|
73
|
+
duration_ms: z.number().int().describe("Duration in milliseconds"),
|
|
74
|
+
description: z.string().optional(),
|
|
75
|
+
billable: z.boolean().optional(),
|
|
76
|
+
tags: z.array(z.string()).optional(),
|
|
77
|
+
},
|
|
78
|
+
}, async (a) => {
|
|
79
|
+
const task_id = await resolver.resolveTaskId(a);
|
|
80
|
+
const body = {
|
|
81
|
+
tid: task_id,
|
|
82
|
+
start: a.start_ms,
|
|
83
|
+
duration: a.duration_ms,
|
|
84
|
+
};
|
|
85
|
+
if (a.description)
|
|
86
|
+
body.description = a.description;
|
|
87
|
+
if (a.billable !== undefined)
|
|
88
|
+
body.billable = a.billable;
|
|
89
|
+
if (a.tags)
|
|
90
|
+
body.tags = a.tags.map((name) => ({ name }));
|
|
91
|
+
const res = await client.post(2, `/team/${client.teamId}/time_entries`, body);
|
|
92
|
+
return { content: [{ type: "text", text: JSON.stringify(res, null, 2) }] };
|
|
93
|
+
});
|
|
94
|
+
}
|
|
95
|
+
//# sourceMappingURL=time.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/tools/time.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
|
|
2
|
+
import { ClickUpClient } from "../clickup/client.js";
|
|
3
|
+
import { Resolver } from "../clickup/resolver.js";
|
|
4
|
+
export declare function registerWorkspaceTools(server: McpServer, client: ClickUpClient, resolver: Resolver): void;
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
export function registerWorkspaceTools(server, client, resolver) {
|
|
2
|
+
server.registerTool("get_workspace_hierarchy", {
|
|
3
|
+
title: "Get workspace hierarchy",
|
|
4
|
+
description: "Returns the full tree of spaces, folders, and lists in the active ClickUp workspace. Use this first to orient before touching tasks/docs.",
|
|
5
|
+
inputSchema: {},
|
|
6
|
+
}, async () => {
|
|
7
|
+
const spaces = await resolver.getSpaces();
|
|
8
|
+
const tree = [];
|
|
9
|
+
for (const sp of spaces) {
|
|
10
|
+
const node = {
|
|
11
|
+
id: sp.id,
|
|
12
|
+
name: sp.name,
|
|
13
|
+
type: "space",
|
|
14
|
+
folders: [],
|
|
15
|
+
folderless_lists: [],
|
|
16
|
+
};
|
|
17
|
+
const folders = await resolver.getFolders(sp.id);
|
|
18
|
+
for (const f of folders) {
|
|
19
|
+
const lists = await resolver.getListsInFolder(f.id);
|
|
20
|
+
node.folders.push({
|
|
21
|
+
id: f.id,
|
|
22
|
+
name: f.name,
|
|
23
|
+
lists: lists.map((l) => ({ id: l.id, name: l.name })),
|
|
24
|
+
});
|
|
25
|
+
}
|
|
26
|
+
const fless = await resolver.getFolderlessLists(sp.id);
|
|
27
|
+
node.folderless_lists = fless.map((l) => ({ id: l.id, name: l.name }));
|
|
28
|
+
tree.push(node);
|
|
29
|
+
}
|
|
30
|
+
return {
|
|
31
|
+
content: [{ type: "text", text: JSON.stringify({ team_id: client.teamId, spaces: tree }, null, 2) }],
|
|
32
|
+
};
|
|
33
|
+
});
|
|
34
|
+
}
|
|
35
|
+
//# sourceMappingURL=workspace.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"workspace.js","sourceRoot":"","sources":["../../src/tools/workspace.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAqB,EAAE,QAAkB;IACjG,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EACT,2IAA2I;QAC7I,WAAW,EAAE,EAAE;KAChB,EACD,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,EAAoC,CAAC;QAClD,KAAK,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,GAA4B;gBACpC,EAAE,EAAE,EAAE,CAAC,EAAE;gBACT,IAAI,EAAE,EAAE,CAAC,IAAI;gBACb,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,EAAe;gBACxB,gBAAgB,EAAE,EAAe;aAClC,CAAC;YACF,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACjD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACnD,IAAI,CAAC,OAAqB,CAAC,IAAI,CAAC;oBAC/B,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;iBACtD,CAAC,CAAC;YACL,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACvD,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACvE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QACD,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACrG,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
export class ClickUpError extends Error {
|
|
2
|
+
status;
|
|
3
|
+
body;
|
|
4
|
+
constructor(status, body, message) {
|
|
5
|
+
super(message ?? `ClickUp API error ${status}: ${typeof body === "object" ? JSON.stringify(body) : String(body)}`);
|
|
6
|
+
this.status = status;
|
|
7
|
+
this.body = body;
|
|
8
|
+
this.name = "ClickUpError";
|
|
9
|
+
}
|
|
10
|
+
}
|
|
11
|
+
export class NotFoundError extends Error {
|
|
12
|
+
constructor(what, query) {
|
|
13
|
+
super(`Could not find ${what} matching "${query}"`);
|
|
14
|
+
this.name = "NotFoundError";
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
//# sourceMappingURL=errors.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAClB;IAAuB;IAA1C,YAAmB,MAAc,EAAS,IAAa,EAAE,OAAgB;QACvE,KAAK,CAAC,OAAO,IAAI,qBAAqB,MAAM,KAAK,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QADlG,WAAM,GAAN,MAAM,CAAQ;QAAS,SAAI,GAAJ,IAAI,CAAS;QAErD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,IAAY,EAAE,KAAa;QACrC,KAAK,CAAC,kBAAkB,IAAI,cAAc,KAAK,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
const LEVELS = ["debug", "info", "warn", "error"];
|
|
2
|
+
const min = process.env.LOG_LEVEL || "info";
|
|
3
|
+
function log(level, msg, meta) {
|
|
4
|
+
if (LEVELS.indexOf(level) < LEVELS.indexOf(min))
|
|
5
|
+
return;
|
|
6
|
+
const line = JSON.stringify({
|
|
7
|
+
t: new Date().toISOString(),
|
|
8
|
+
level,
|
|
9
|
+
msg,
|
|
10
|
+
...(meta !== undefined ? { meta } : {}),
|
|
11
|
+
});
|
|
12
|
+
process.stderr.write(line + "\n");
|
|
13
|
+
}
|
|
14
|
+
export const logger = {
|
|
15
|
+
debug: (m, x) => log("debug", m, x),
|
|
16
|
+
info: (m, x) => log("info", m, x),
|
|
17
|
+
warn: (m, x) => log("warn", m, x),
|
|
18
|
+
error: (m, x) => log("error", m, x),
|
|
19
|
+
};
|
|
20
|
+
//# sourceMappingURL=logger.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU,CAAC;AAE3D,MAAM,GAAG,GAAI,OAAO,CAAC,GAAG,CAAC,SAAmB,IAAI,MAAM,CAAC;AAEvD,SAAS,GAAG,CAAC,KAAY,EAAE,GAAW,EAAE,IAAc;IACpD,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC3B,KAAK;QACL,GAAG;QACH,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxC,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,CAAC,CAAS,EAAE,CAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACrD,IAAI,EAAE,CAAC,CAAS,EAAE,CAAW,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACnD,IAAI,EAAE,CAAC,CAAS,EAAE,CAAW,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;IACnD,KAAK,EAAE,CAAC,CAAS,EAAE,CAAW,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;CACtD,CAAC"}
|