@atikk-co-jp/notion-mcp-server 0.5.0 → 0.7.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.
Files changed (36) hide show
  1. package/README.ja.md +14 -3
  2. package/README.md +33 -5
  3. package/dist/src/notion-client.d.ts +2 -0
  4. package/dist/src/notion-client.d.ts.map +1 -1
  5. package/dist/src/tools/archive-database.d.ts.map +1 -1
  6. package/dist/src/tools/archive-database.js +1 -2
  7. package/dist/src/tools/archive-page.d.ts.map +1 -1
  8. package/dist/src/tools/archive-page.js +1 -2
  9. package/dist/src/tools/create-comment-simple.d.ts +4 -0
  10. package/dist/src/tools/create-comment-simple.d.ts.map +1 -0
  11. package/dist/src/tools/create-comment-simple.js +50 -0
  12. package/dist/src/tools/create-comment.d.ts.map +1 -1
  13. package/dist/src/tools/create-comment.js +22 -5
  14. package/dist/src/tools/create-page-simple.d.ts.map +1 -1
  15. package/dist/src/tools/create-page-simple.js +24 -8
  16. package/dist/src/tools/create-page.js +2 -2
  17. package/dist/src/tools/get-block-children.js +1 -1
  18. package/dist/src/tools/index.d.ts +2 -1
  19. package/dist/src/tools/index.d.ts.map +1 -1
  20. package/dist/src/tools/index.js +3 -1
  21. package/dist/src/tools/query-data-source.d.ts.map +1 -1
  22. package/dist/src/tools/query-data-source.js +8 -2
  23. package/dist/src/tools/retrieve-page-property.d.ts.map +1 -1
  24. package/dist/src/tools/retrieve-page-property.js +1 -2
  25. package/dist/src/tools/update-data-source.js +2 -2
  26. package/dist/src/tools/update-database.d.ts.map +1 -1
  27. package/dist/src/tools/update-database.js +6 -2
  28. package/dist/src/tools/update-page.d.ts.map +1 -1
  29. package/dist/src/tools/update-page.js +12 -5
  30. package/dist/src/utils/error-handler.d.ts +11 -0
  31. package/dist/src/utils/error-handler.d.ts.map +1 -1
  32. package/dist/src/utils/error-handler.js +36 -0
  33. package/dist/src/utils/index.d.ts +1 -1
  34. package/dist/src/utils/index.d.ts.map +1 -1
  35. package/dist/src/utils/index.js +1 -1
  36. package/package.json +1 -1
package/README.ja.md CHANGED
@@ -196,7 +196,15 @@ Markdownを使ってページを作成します。`create-page`と比較して**
196
196
 
197
197
  ### update-page
198
198
 
199
- ページのプロパティを更新します。
199
+ ページのプロパティ、アイコン、カバー、アーカイブ状態、ロック状態を更新します。
200
+
201
+ **パラメータ:**
202
+ - `page_id` (必須): 更新するページのID
203
+ - `properties` (任意): 更新するプロパティ
204
+ - `icon` (任意): アイコン（nullで削除）
205
+ - `cover` (任意): カバー画像（nullで削除）
206
+ - `archived` (任意): trueでアーカイブ
207
+ - `is_locked` (任意): ページをロックしてUI上での編集を防止
200
208
 
201
209
  ```json
202
210
  {
@@ -205,7 +213,8 @@ Markdownを使ってページを作成します。`create-page`と比較して**
205
213
  "Status": {
206
214
  "status": { "name": "完了" }
207
215
  }
208
- }
216
+ },
217
+ "is_locked": true
209
218
  }
210
219
  ```
211
220
 
@@ -275,11 +284,13 @@ Markdownを使ってページを作成します。`create-page`と比較して**
275
284
  - `cover` (任意): カバー画像（nullで削除）
276
285
  - `is_inline` (任意): trueの場合、インラインデータベースとして作成
277
286
  - `archived` (任意): trueでアーカイブ
287
+ - `is_locked` (任意): データベースをロックしてUI上での編集を防止
278
288
 
279
289
  ```json
280
290
  {
281
291
  "database_id": "データベースのUUID",
282
- "title": [{ "type": "text", "text": { "content": "新しいタイトル" } }]
292
+ "title": [{ "type": "text", "text": { "content": "新しいタイトル" } }],
293
+ "is_locked": true
283
294
  }
284
295
  ```
285
296
 
package/README.md CHANGED
@@ -21,6 +21,8 @@ MCP (Model Context Protocol) server for Notion API. Enables AI assistants to int
21
21
 
22
22
  ## API Coverage
23
23
 
24
+ > ⭐ = Markdown input supported (reduces input tokens by ~80%)
25
+
24
26
  | Category | Notion API | MCP Tool | Format |
25
27
  |----------|-----------|----------|--------|
26
28
  | **Pages** | | | |
@@ -50,6 +52,7 @@ MCP (Model Context Protocol) server for Notion API. Enables AI assistants to int
50
52
  | | | `append-blocks-simple` ⭐ | Markdown |
51
53
  | **Comments** | | | |
52
54
  | | [Create comment](https://developers.notion.com/reference/create-a-comment) | `create-comment` | JSON |
55
+ | | | `create-comment-simple` ⭐ | Markdown |
53
56
  | | [List comments](https://developers.notion.com/reference/retrieve-comments) | `list-comments` | JSON |
54
57
  | **Users** | | | |
55
58
  | | [List users](https://developers.notion.com/reference/get-users) | `list-users` | JSON |
@@ -58,8 +61,6 @@ MCP (Model Context Protocol) server for Notion API. Enables AI assistants to int
58
61
  | **Search** | | | |
59
62
  | | [Search](https://developers.notion.com/reference/post-search) | `search` | JSON |
60
63
 
61
- ⭐ = Markdown input supported (reduces input tokens by ~80%)
62
-
63
64
  ## Installation
64
65
 
65
66
  ```bash
@@ -196,7 +197,15 @@ Create a new page using Markdown. **~80% fewer output tokens** compared to `crea
196
197
 
197
198
  ### update-page
198
199
 
199
- Update a page's properties.
200
+ Update a page's properties, icon, cover, archive status, or lock status.
201
+
202
+ **Parameters:**
203
+ - `page_id` (required): The ID of the page to update
204
+ - `properties` (optional): Properties to update
205
+ - `icon` (optional): Icon (set to null to remove)
206
+ - `cover` (optional): Cover image (set to null to remove)
207
+ - `archived` (optional): Set to true to archive
208
+ - `is_locked` (optional): Lock the page to prevent edits in the UI
200
209
 
201
210
  ```json
202
211
  {
@@ -205,7 +214,8 @@ Update a page's properties.
205
214
  "Status": {
206
215
  "status": { "name": "Done" }
207
216
  }
208
- }
217
+ },
218
+ "is_locked": true
209
219
  }
210
220
  ```
211
221
 
@@ -275,11 +285,13 @@ Update an existing database container (title, description, icon, cover).
275
285
  - `cover` (optional): Cover image (set to null to remove)
276
286
  - `is_inline` (optional): If true, creates an inline database
277
287
  - `archived` (optional): Set to true to archive
288
+ - `is_locked` (optional): Lock the database to prevent edits in the UI
278
289
 
279
290
  ```json
280
291
  {
281
292
  "database_id": "database-uuid-here",
282
- "title": [{ "type": "text", "text": { "content": "New Title" } }]
293
+ "title": [{ "type": "text", "text": { "content": "New Title" } }],
294
+ "is_locked": true
283
295
  }
284
296
  ```
285
297
 
@@ -403,6 +415,22 @@ Add a comment to a page.
403
415
  }
404
416
  ```
405
417
 
418
+ ### create-comment-simple ⭐
419
+
420
+ Add a comment using Markdown. Simpler than `create-comment`.
421
+
422
+ **Parameters:**
423
+ - `page_id` (required): The ID of the page
424
+ - `content` (required): Comment in Markdown
425
+ - `discussion_id` (optional): Reply to existing thread
426
+
427
+ ```json
428
+ {
429
+ "page_id": "page-uuid-here",
430
+ "content": "This is **important** with a [link](https://example.com)"
431
+ }
432
+ ```
433
+
406
434
  ## Development
407
435
 
408
436
  ```bash
package/dist/src/notion-client.d.ts CHANGED
@@ -52,6 +52,7 @@ export declare class NotionClient {
52
52
  archived?: boolean;
53
53
  icon?: Icon | null;
54
54
  cover?: Cover | null;
55
+ is_locked?: boolean;
55
56
  }) => Promise<T>;
56
57
  retrieveProperty: <T>(params: {
57
58
  page_id: string;
@@ -110,6 +111,7 @@ export declare class NotionClient {
110
111
  cover?: Cover | null;
111
112
  is_inline?: boolean;
112
113
  archived?: boolean;
114
+ is_locked?: boolean;
113
115
  }) => Promise<T>;
114
116
  };
115
117
  blocks: {
package/dist/src/notion-client.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"notion-client.d.ts","sourceRoot":"","sources":["../../src/notion-client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"notion-client.d.ts","sourceRoot":"","sources":["../../src/notion-client.ts"],"names":[],"mappings":"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"}
package/dist/src/tools/archive-database.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"archive-database.d.ts","sourceRoot":"","sources":["../../../src/tools/archive-database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAOvD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqBrF"}
1
+ {"version":3,"file":"archive-database.d.ts","sourceRoot":"","sources":["../../../src/tools/archive-database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAOvD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAoBrF"}
package/dist/src/tools/archive-database.js CHANGED
@@ -5,8 +5,7 @@ const inputSchema = {
5
5
  };
6
6
  export function registerArchiveDatabase(server, notion) {
7
7
  server.registerTool('archive-database', {
8
- description: 'Archive (delete) a Notion database by moving it to trash. ' +
9
- 'This is equivalent to update-database with archived: true.',
8
+ description: 'Move a database to trash. Recoverable for 30 days via Notion UI.',
10
9
  inputSchema,
11
10
  }, async ({ database_id }) => {
12
11
  try {
package/dist/src/tools/archive-page.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"archive-page.d.ts","sourceRoot":"","sources":["../../../src/tools/archive-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAOvD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqBjF"}
1
+ {"version":3,"file":"archive-page.d.ts","sourceRoot":"","sources":["../../../src/tools/archive-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAOvD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAoBjF"}
package/dist/src/tools/archive-page.js CHANGED
@@ -5,8 +5,7 @@ const inputSchema = {
5
5
  };
6
6
  export function registerArchivePage(server, notion) {
7
7
  server.registerTool('archive-page', {
8
- description: 'Archive (delete) a Notion page by moving it to trash. ' +
9
- 'This is equivalent to update-page with archived: true.',
8
+ description: 'Move a page to trash. Recoverable for 30 days via Notion UI.',
10
9
  inputSchema,
11
10
  }, async ({ page_id }) => {
12
11
  try {
package/dist/src/tools/create-comment-simple.d.ts ADDED
@@ -0,0 +1,4 @@
1
+ import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import type { NotionClient } from '../notion-client.js';
3
+ export declare function registerCreateCommentSimple(server: McpServer, notion: NotionClient): void;
4
+ //# sourceMappingURL=create-comment-simple.d.ts.map
package/dist/src/tools/create-comment-simple.d.ts.map ADDED
@@ -0,0 +1 @@
1
+ {"version":3,"file":"create-comment-simple.d.ts","sourceRoot":"","sources":["../../../src/tools/create-comment-simple.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAUvD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAmDzF"}
package/dist/src/tools/create-comment-simple.js ADDED
@@ -0,0 +1,50 @@
1
+ import { z } from 'zod';
2
+ import { parseInlineMarkdown } from '../converters/index.js';
3
+ import { formatResponse, handleError } from '../utils/index.js';
4
+ const inputSchema = {
5
+ page_id: z.string().optional().describe('Page ID (for page comments)'),
6
+ block_id: z.string().optional().describe('Block ID (for block comments)'),
7
+ discussion_id: z.string().optional().describe('Discussion ID (for replies)'),
8
+ content: z.string().describe('Comment in Markdown (**bold**, *italic*, [link](url), `code`)'),
9
+ };
10
+ export function registerCreateCommentSimple(server, notion) {
11
+ server.registerTool('create-comment-simple', {
12
+ description: 'Add a comment using Markdown. Simpler than create-comment.',
13
+ inputSchema,
14
+ }, async ({ page_id, block_id, discussion_id, content }) => {
15
+ try {
16
+ // Validate: exactly one of page_id, block_id, or discussion_id must be provided
17
+ const providedCount = [page_id, block_id, discussion_id].filter(Boolean).length;
18
+ if (providedCount !== 1) {
19
+ return {
20
+ content: [
21
+ {
22
+ type: 'text',
23
+ text: 'Error: Provide exactly one of page_id, block_id, or discussion_id.',
24
+ },
25
+ ],
26
+ isError: true,
27
+ };
28
+ }
29
+ const rich_text = parseInlineMarkdown(content);
30
+ // Build params based on which ID was provided
31
+ const params = {
32
+ rich_text,
33
+ };
34
+ if (discussion_id) {
35
+ params.discussion_id = discussion_id;
36
+ }
37
+ else if (page_id) {
38
+ params.parent = { page_id };
39
+ }
40
+ else if (block_id) {
41
+ params.parent = { block_id };
42
+ }
43
+ const response = await notion.comments.create(params);
44
+ return formatResponse(response);
45
+ }
46
+ catch (error) {
47
+ return handleError(error);
48
+ }
49
+ });
50
+ }
package/dist/src/tools/create-comment.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"create-comment.d.ts","sourceRoot":"","sources":["../../../src/tools/create-comment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAUvD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqCnF"}
1
+ {"version":3,"file":"create-comment.d.ts","sourceRoot":"","sources":["../../../src/tools/create-comment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAWvD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAqDnF"}
package/dist/src/tools/create-comment.js CHANGED
@@ -2,9 +2,10 @@ import { z } from 'zod';
2
2
  import { formatResponse, handleError } from '../utils/index.js';
3
3
  // Minimal schema for MCP (full validation by Notion API)
4
4
  const inputSchema = {
5
- page_id: z.string().describe('Page ID'),
5
+ page_id: z.string().optional().describe('Page ID (for page comments)'),
6
+ block_id: z.string().optional().describe('Block ID (for block comments)'),
7
+ discussion_id: z.string().optional().describe('Discussion ID (for replies)'),
6
8
  rich_text: z.array(z.any()).describe('Comment content as rich text'),
7
- discussion_id: z.string().optional().describe('Reply to existing discussion'),
8
9
  };
9
10
  export function registerCreateComment(server, notion) {
10
11
  server.registerTool('create-comment', {
@@ -13,18 +14,34 @@ export function registerCreateComment(server, notion) {
13
14
  'Use discussion_id to reply to an existing comment thread. ' +
14
15
  'Returns the created comment with its ID.',
15
16
  inputSchema,
16
- }, async ({ page_id, rich_text, discussion_id }) => {
17
+ }, async ({ page_id, block_id, discussion_id, rich_text }) => {
17
18
  try {
18
- // The Notion API requires either parent or discussion_id
19
+ // Validate: exactly one of page_id, block_id, or discussion_id must be provided
20
+ const providedCount = [page_id, block_id, discussion_id].filter(Boolean).length;
21
+ if (providedCount !== 1) {
22
+ return {
23
+ content: [
24
+ {
25
+ type: 'text',
26
+ text: 'Error: Provide exactly one of page_id, block_id, or discussion_id.',
27
+ },
28
+ ],
29
+ isError: true,
30
+ };
31
+ }
32
+ // Build params based on which ID was provided
19
33
  const params = {
20
34
  rich_text,
21
35
  };
22
36
  if (discussion_id) {
23
37
  params.discussion_id = discussion_id;
24
38
  }
25
- else {
39
+ else if (page_id) {
26
40
  params.parent = { page_id };
27
41
  }
42
+ else if (block_id) {
43
+ params.parent = { block_id };
44
+ }
28
45
  const response = await notion.comments.create(params);
29
46
  return formatResponse(response);
30
47
  }
package/dist/src/tools/create-page-simple.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"create-page-simple.d.ts","sourceRoot":"","sources":["../../../src/tools/create-page-simple.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAYvD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA4DtF"}
1
+ {"version":3,"file":"create-page-simple.d.ts","sourceRoot":"","sources":["../../../src/tools/create-page-simple.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAqBvD,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA+EtF"}
package/dist/src/tools/create-page-simple.js CHANGED
@@ -1,6 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { markdownToBlocks } from '../converters/index.js';
3
- import { formatResponse, handleError } from '../utils/index.js';
3
+ import { formatResponse, handleErrorWithContext } from '../utils/index.js';
4
4
  // Minimal schema for MCP
5
5
  const inputSchema = {
6
6
  data_source_id: z.string().describe('Data source ID (required in API 2025-09-03)'),
@@ -11,13 +11,26 @@ const inputSchema = {
11
11
  };
12
12
  export function registerCreatePageSimple(server, notion) {
13
13
  server.registerTool('create-page-simple', {
14
- description: 'Create a Notion page with Markdown content. ' +
15
- 'Simpler than create-page: just provide title and markdown text. ' +
16
- 'Supports: headings (#), lists (- or 1.), checkboxes (- [ ]), code blocks (```), quotes (>), images (![]()), bold (**), italic (*), links ([]()), etc. ' +
17
- '(API version 2025-09-03)',
14
+ description: 'Create a page with Markdown. Title is auto-mapped to the database title property. ' +
15
+ 'Supports: # headings, - lists, - [ ] checkboxes, ``` code, > quotes, **bold**, *italic*, [links]().',
18
16
  inputSchema,
19
17
  }, async ({ data_source_id, title, content, properties, icon }) => {
20
18
  try {
19
+ // Try to fetch data source schema to find the title property name
20
+ let titlePropertyName = 'Name'; // Default fallback
21
+ try {
22
+ const schema = await notion.dataSources.retrieve({
23
+ data_source_id,
24
+ });
25
+ // Find the title property name from schema
26
+ const foundTitleProp = Object.entries(schema.properties).find(([, prop]) => prop.type === 'title');
27
+ if (foundTitleProp) {
28
+ titlePropertyName = foundTitleProp[0];
29
+ }
30
+ }
31
+ catch {
32
+ // If schema fetch fails, fall back to 'Name'
33
+ }
21
34
  // Build properties with title
22
35
  const pageProperties = {
23
36
  ...properties,
@@ -25,9 +38,9 @@ export function registerCreatePageSimple(server, notion) {
25
38
  // Check if any title property is already provided
26
39
  // Title properties have the structure: { title: [...] }
27
40
  const hasTitleProperty = Object.values(pageProperties).some((prop) => prop && typeof prop === 'object' && 'title' in prop);
28
- // Only add Name if no title property exists
41
+ // Add title property if not already provided
29
42
  if (!hasTitleProperty) {
30
- pageProperties.Name = {
43
+ pageProperties[titlePropertyName] = {
31
44
  title: [{ type: 'text', text: { content: title } }],
32
45
  };
33
46
  }
@@ -49,7 +62,10 @@ export function registerCreatePageSimple(server, notion) {
49
62
  return formatResponse(response);
50
63
  }
51
64
  catch (error) {
52
- return handleError(error);
65
+ return handleErrorWithContext(error, notion, data_source_id, {
66
+ hint: 'Hint: The "title" parameter automatically sets the title property. ' +
67
+ 'Use "properties" for other fields like select or multi_select.',
68
+ });
53
69
  }
54
70
  });
55
71
  }
package/dist/src/tools/create-page.js CHANGED
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { formatResponse, handleError } from '../utils/index.js';
2
+ import { formatResponse, handleErrorWithContext } from '../utils/index.js';
3
3
  // Minimal schema for MCP (full validation by Notion API)
4
4
  const inputSchema = {
5
5
  data_source_id: z.string().describe('Data source ID (required in API 2025-09-03)'),
@@ -33,7 +33,7 @@ export function registerCreatePage(server, notion) {
33
33
  return formatResponse(response);
34
34
  }
35
35
  catch (error) {
36
- return handleError(error);
36
+ return handleErrorWithContext(error, notion, data_source_id);
37
37
  }
38
38
  });
39
39
  }
package/dist/src/tools/get-block-children.js CHANGED
@@ -22,7 +22,7 @@ const inputSchema = {
22
22
  .boolean()
23
23
  .optional()
24
24
  .default(false)
25
- .describe("When format='markdown', fetch nested children blocks recursively (toggle, list items with children, etc.). Default is false."),
25
+ .describe('Fetch nested children recursively. Default false. WARNING: causes many API calls for deep structures.'),
26
26
  };
27
27
  export function registerGetBlockChildren(server, notion) {
28
28
  server.registerTool('get-block-children', {
package/dist/src/tools/index.d.ts CHANGED
@@ -5,6 +5,7 @@ import { registerAppendBlocksSimple } from './append-blocks-simple.js';
5
5
  import { registerArchiveDatabase } from './archive-database.js';
6
6
  import { registerArchivePage } from './archive-page.js';
7
7
  import { registerCreateComment } from './create-comment.js';
8
+ import { registerCreateCommentSimple } from './create-comment-simple.js';
8
9
  import { registerCreateDatabase } from './create-database.js';
9
10
  import { registerCreatePage } from './create-page.js';
10
11
  import { registerCreatePageSimple } from './create-page-simple.js';
@@ -28,5 +29,5 @@ import { registerUpdateDatabase } from './update-database.js';
28
29
  import { registerUpdateDataSource } from './update-data-source.js';
29
30
  import { registerUpdatePage } from './update-page.js';
30
31
  export declare function registerAllTools(server: McpServer, notion: NotionClient): void;
31
- export { registerRetrievePage, registerCreatePage, registerCreatePageSimple, registerUpdatePage, registerArchivePage, registerRetrievePageProperty, registerMovePage, registerCreateDatabase, registerUpdateDatabase, registerArchiveDatabase, registerRetrieveDatabase, registerRetrieveDataSource, registerQueryDataSource, registerUpdateDataSource, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerAppendBlocksSimple, registerRetrieveBlock, registerUpdateBlock, registerUpdateBlockSimple, registerDeleteBlock, registerCreateComment, registerListComments, registerListUsers, registerRetrieveUser, registerRetrieveBotUser, };
32
+ export { registerRetrievePage, registerCreatePage, registerCreatePageSimple, registerUpdatePage, registerArchivePage, registerRetrievePageProperty, registerMovePage, registerCreateDatabase, registerUpdateDatabase, registerArchiveDatabase, registerRetrieveDatabase, registerRetrieveDataSource, registerQueryDataSource, registerUpdateDataSource, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerAppendBlocksSimple, registerRetrieveBlock, registerUpdateBlock, registerUpdateBlockSimple, registerDeleteBlock, registerCreateComment, registerCreateCommentSimple, registerListComments, registerListUsers, registerRetrieveUser, registerRetrieveBotUser, };
32
33
  //# sourceMappingURL=index.d.ts.map
package/dist/src/tools/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAA;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAyC9E;AAED,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,GACxB,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AACxE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAA;AAC1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAA;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAA;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAErD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA0C9E;AAED,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,mBAAmB,EACnB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,wBAAwB,EACxB,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,2BAA2B,EAC3B,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,uBAAuB,GACxB,CAAA"}
package/dist/src/tools/index.js CHANGED
@@ -3,6 +3,7 @@ import { registerAppendBlocksSimple } from './append-blocks-simple.js';
3
3
  import { registerArchiveDatabase } from './archive-database.js';
4
4
  import { registerArchivePage } from './archive-page.js';
5
5
  import { registerCreateComment } from './create-comment.js';
6
+ import { registerCreateCommentSimple } from './create-comment-simple.js';
6
7
  import { registerCreateDatabase } from './create-database.js';
7
8
  import { registerCreatePage } from './create-page.js';
8
9
  import { registerCreatePageSimple } from './create-page-simple.js';
@@ -55,10 +56,11 @@ export function registerAllTools(server, notion) {
55
56
  registerDeleteBlock(server, notion);
56
57
  // Comment operations
57
58
  registerCreateComment(server, notion);
59
+ registerCreateCommentSimple(server, notion);
58
60
  registerListComments(server, notion);
59
61
  // User operations
60
62
  registerListUsers(server, notion);
61
63
  registerRetrieveUser(server, notion);
62
64
  registerRetrieveBotUser(server, notion);
63
65
  }
64
- export { registerRetrievePage, registerCreatePage, registerCreatePageSimple, registerUpdatePage, registerArchivePage, registerRetrievePageProperty, registerMovePage, registerCreateDatabase, registerUpdateDatabase, registerArchiveDatabase, registerRetrieveDatabase, registerRetrieveDataSource, registerQueryDataSource, registerUpdateDataSource, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerAppendBlocksSimple, registerRetrieveBlock, registerUpdateBlock, registerUpdateBlockSimple, registerDeleteBlock, registerCreateComment, registerListComments, registerListUsers, registerRetrieveUser, registerRetrieveBotUser, };
66
+ export { registerRetrievePage, registerCreatePage, registerCreatePageSimple, registerUpdatePage, registerArchivePage, registerRetrievePageProperty, registerMovePage, registerCreateDatabase, registerUpdateDatabase, registerArchiveDatabase, registerRetrieveDatabase, registerRetrieveDataSource, registerQueryDataSource, registerUpdateDataSource, registerSearch, registerGetBlockChildren, registerAppendBlockChildren, registerAppendBlocksSimple, registerRetrieveBlock, registerUpdateBlock, registerUpdateBlockSimple, registerDeleteBlock, registerCreateComment, registerCreateCommentSimple, registerListComments, registerListUsers, registerRetrieveUser, registerRetrieveBotUser, };
package/dist/src/tools/query-data-source.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"query-data-source.d.ts","sourceRoot":"","sources":["../../../src/tools/query-data-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AA8BvD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAsDrF"}
1
+ {"version":3,"file":"query-data-source.d.ts","sourceRoot":"","sources":["../../../src/tools/query-data-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAGxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAoCvD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAsDrF"}
package/dist/src/tools/query-data-source.js CHANGED
@@ -4,8 +4,14 @@ import { formatPaginatedResponse, formatSimplePaginatedResponse, handleError, }
4
4
  // Minimal schema for MCP (full validation by Notion API)
5
5
  const inputSchema = {
6
6
  data_source_id: z.string().describe('Data source ID'),
7
- filter: z.any().optional().describe('Filter conditions'),
8
- sorts: z.array(z.any()).optional().describe('Sort conditions'),
7
+ filter: z
8
+ .any()
9
+ .optional()
10
+ .describe('Filter object. Example: {"property":"Status","select":{"equals":"Done"}}'),
11
+ sorts: z
12
+ .array(z.any())
13
+ .optional()
14
+ .describe('Sort array. Example: [{"property":"Date","direction":"descending"}]'),
9
15
  start_cursor: z.string().optional().describe('Pagination cursor'),
10
16
  page_size: z.number().optional().describe('Results per page (1-100)'),
11
17
  format: z.enum(['json', 'simple']).optional().describe('Output format (default: simple)'),
package/dist/src/tools/retrieve-page-property.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"retrieve-page-property.d.ts","sourceRoot":"","sources":["../../../src/tools/retrieve-page-property.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAmBvD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAkC1F"}
1
+ {"version":3,"file":"retrieve-page-property.d.ts","sourceRoot":"","sources":["../../../src/tools/retrieve-page-property.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAmBvD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAiC1F"}
package/dist/src/tools/retrieve-page-property.js CHANGED
@@ -8,8 +8,7 @@ const inputSchema = {
8
8
  };
9
9
  export function registerRetrievePageProperty(server, notion) {
10
10
  server.registerTool('retrieve-page-property', {
11
- description: 'Retrieve a specific property value from a page. Supports pagination for properties with many values (e.g., rollup, relation). ' +
12
- 'Use the property_id from the page properties object.',
11
+ description: 'Get a property with pagination (for relation/rollup with many items). For simple properties, use retrieve-page instead.',
13
12
  inputSchema,
14
13
  }, async ({ page_id, property_id, start_cursor, page_size }) => {
15
14
  try {
package/dist/src/tools/update-data-source.js CHANGED
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { formatResponse, handleError } from '../utils/index.js';
2
+ import { formatResponse, handleErrorWithContext } from '../utils/index.js';
3
3
  // Minimal schema for MCP (full validation by Notion API)
4
4
  const inputSchema = {
5
5
  data_source_id: z.string().describe('Data source ID'),
@@ -25,7 +25,7 @@ export function registerUpdateDataSource(server, notion) {
25
25
  return formatResponse(response);
26
26
  }
27
27
  catch (error) {
28
- return handleError(error);
28
+ return handleErrorWithContext(error, notion, data_source_id);
29
29
  }
30
30
  });
31
31
  }
package/dist/src/tools/update-database.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"update-database.d.ts","sourceRoot":"","sources":["../../../src/tools/update-database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAevD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAuDpF"}
1
+ {"version":3,"file":"update-database.d.ts","sourceRoot":"","sources":["../../../src/tools/update-database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAgBvD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA4DpF"}
package/dist/src/tools/update-database.js CHANGED
@@ -10,13 +10,14 @@ const inputSchema = {
10
10
  cover: z.any().optional().describe('Cover (null to remove)'),
11
11
  is_inline: z.boolean().optional().describe('Inline database'),
12
12
  archived: z.boolean().optional().describe('Archive status'),
13
+ is_locked: z.boolean().optional().describe('Lock the database to prevent edits in the UI. Set to true to lock, false to unlock.'),
13
14
  };
14
15
  export function registerUpdateDatabase(server, notion) {
15
16
  server.registerTool('update-database', {
16
- description: 'Update a Notion database container. Can modify title, description, icon, cover, inline status, and archive status. ' +
17
+ description: 'Update a Notion database container. Can modify title, description, icon, cover, inline status, archive status, and lock status. ' +
17
18
  'For schema (properties/columns) updates, use update-data-source instead. (API version 2025-09-03)',
18
19
  inputSchema,
19
- }, async ({ database_id, title, description, icon, cover, is_inline, archived }) => {
20
+ }, async ({ database_id, title, description, icon, cover, is_inline, archived, is_locked }) => {
20
21
  try {
21
22
  const params = {
22
23
  database_id,
@@ -39,6 +40,9 @@ export function registerUpdateDatabase(server, notion) {
39
40
  if (archived !== undefined) {
40
41
  params.archived = archived;
41
42
  }
43
+ if (is_locked !== undefined) {
44
+ params.is_locked = is_locked;
45
+ }
42
46
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
43
47
  const response = await notion.databases.update(params);
44
48
  return formatResponse(response);
package/dist/src/tools/update-page.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"update-page.d.ts","sourceRoot":"","sources":["../../../src/tools/update-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAiBvD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA4ChF"}
1
+ {"version":3,"file":"update-page.d.ts","sourceRoot":"","sources":["../../../src/tools/update-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAkBvD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAoDhF"}
package/dist/src/tools/update-page.js CHANGED
@@ -1,5 +1,5 @@
1
1
  import { z } from 'zod';
2
- import { formatResponse, handleError } from '../utils/index.js';
2
+ import { formatResponse, handleErrorWithContext } from '../utils/index.js';
3
3
  // Minimal schema for MCP (full validation by Notion API)
4
4
  const inputSchema = {
5
5
  page_id: z.string().describe('Page ID'),
@@ -7,15 +7,17 @@ const inputSchema = {
7
7
  archived: z.boolean().optional().describe('Archive the page'),
8
8
  icon: z.any().optional().describe('Page icon { type: "emoji", emoji: "📝" } or { type: "external", external: { url: "..." } }, or null to remove. Emoji must be an actual emoji character.'),
9
9
  cover: z.any().optional().describe('Cover image (null to remove)'),
10
+ is_locked: z.boolean().optional().describe('Lock the page to prevent edits in the UI. Set to true to lock, false to unlock.'),
10
11
  };
11
12
  export function registerUpdatePage(server, notion) {
12
13
  server.registerTool('update-page', {
13
- description: "Update a Notion page's properties, icon, cover, or archive status. " +
14
+ description: "Update a Notion page's properties, icon, cover, archive status, or lock status. " +
14
15
  'Partial updates are supported - only provide the fields you want to change. ' +
15
16
  'Set icon or cover to null to remove them. ' +
16
- 'Set archived to true to move the page to trash.',
17
+ 'Set archived to true to move the page to trash. ' +
18
+ 'Set is_locked to true to lock the page in the UI.',
17
19
  inputSchema,
18
- }, async ({ page_id, properties, archived, icon, cover }) => {
20
+ }, async ({ page_id, properties, archived, icon, cover, is_locked }) => {
19
21
  try {
20
22
  const params = { page_id };
21
23
  if (properties !== undefined) {
@@ -30,11 +32,16 @@ export function registerUpdatePage(server, notion) {
30
32
  if (cover !== undefined) {
31
33
  params.cover = cover;
32
34
  }
35
+ if (is_locked !== undefined) {
36
+ params.is_locked = is_locked;
37
+ }
33
38
  const response = await notion.pages.update(params);
34
39
  return formatResponse(response);
35
40
  }
36
41
  catch (error) {
37
- return handleError(error);
42
+ // Note: update-page uses page_id, not data_source_id,
43
+ // so we can't show available properties without additional API call
44
+ return handleErrorWithContext(error, notion);
38
45
  }
39
46
  });
40
47
  }
package/dist/src/utils/error-handler.d.ts CHANGED
@@ -1,3 +1,4 @@
1
+ import type { NotionClient } from '../notion-client.js';
1
2
  export interface McpTextContent {
2
3
  type: 'text';
3
4
  text: string;
@@ -8,4 +9,14 @@ export interface McpResponse {
8
9
  isError?: boolean;
9
10
  }
10
11
  export declare function handleError(error: unknown): McpResponse;
12
+ interface HandleErrorOptions {
13
+ /** Additional hint to append after property list (e.g., usage examples) */
14
+ hint?: string;
15
+ }
16
+ /**
17
+ * Enhanced error handler that includes available properties for validation errors.
18
+ * Use this for tools that operate on data sources (create-page, update-page, etc.)
19
+ */
20
+ export declare function handleErrorWithContext(error: unknown, notion: NotionClient, dataSourceId?: string, options?: HandleErrorOptions): Promise<McpResponse>;
21
+ export {};
11
22
  //# sourceMappingURL=error-handler.d.ts.map
package/dist/src/utils/error-handler.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAaD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAoBvD"}
1
+ {"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../../src/utils/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAEvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAW;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,OAAO,EAAE,cAAc,EAAE,CAAA;IACzB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAkBD,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAoBvD;AA2DD,UAAU,kBAAkB;IAC1B,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,YAAY,EACpB,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,WAAW,CAAC,CAsBtB"}
package/dist/src/utils/error-handler.js CHANGED
@@ -62,3 +62,39 @@ function formatNotionError(error) {
62
62
  return error.message;
63
63
  }
64
64
  }
65
+ function isValidationError(error) {
66
+ if (!(error instanceof Error))
67
+ return false;
68
+ // Check if error message contains validation_error code
69
+ return error.message.includes('validation_error');
70
+ }
71
+ function formatPropertyList(properties) {
72
+ return Object.entries(properties)
73
+ .map(([name, prop]) => ` - ${name} (${prop.type})`)
74
+ .join('\n');
75
+ }
76
+ /**
77
+ * Enhanced error handler that includes available properties for validation errors.
78
+ * Use this for tools that operate on data sources (create-page, update-page, etc.)
79
+ */
80
+ export async function handleErrorWithContext(error, notion, dataSourceId, options) {
81
+ const baseResponse = handleError(error);
82
+ // For validation errors with a data source ID, append available properties
83
+ if (isValidationError(error) && dataSourceId) {
84
+ try {
85
+ const schema = await notion.dataSources.retrieve({
86
+ data_source_id: dataSourceId,
87
+ });
88
+ const propList = formatPropertyList(schema.properties);
89
+ baseResponse.content[0].text += `\n\nAvailable properties:\n${propList}`;
90
+ // Add optional hint
91
+ if (options?.hint) {
92
+ baseResponse.content[0].text += `\n\n${options.hint}`;
93
+ }
94
+ }
95
+ catch {
96
+ // Ignore schema fetch errors - keep the original error message
97
+ }
98
+ }
99
+ return baseResponse;
100
+ }
package/dist/src/utils/index.d.ts CHANGED
@@ -1,3 +1,3 @@
1
- export { handleError, type McpResponse, type McpTextContent } from './error-handler.js';
1
+ export { handleError, handleErrorWithContext, type McpResponse, type McpTextContent } from './error-handler.js';
2
2
  export { formatMarkdownResponse, formatPaginatedResponse, formatResponse, formatSimplePaginatedResponse, formatSimpleResponse, formatSuccessMessage, } from './response-formatter.js';
3
3
  //# sourceMappingURL=index.d.ts.map
package/dist/src/utils/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACvF,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,6BAA6B,EAC7B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,yBAAyB,CAAA"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,KAAK,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAC/G,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,6BAA6B,EAC7B,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,yBAAyB,CAAA"}
package/dist/src/utils/index.js CHANGED
@@ -1,2 +1,2 @@
1
- export { handleError } from './error-handler.js';
1
+ export { handleError, handleErrorWithContext } from './error-handler.js';
2
2
  export { formatMarkdownResponse, formatPaginatedResponse, formatResponse, formatSimplePaginatedResponse, formatSimpleResponse, formatSuccessMessage, } from './response-formatter.js';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atikk-co-jp/notion-mcp-server",
3
- "version": "0.5.0",
3
+ "version": "0.7.0",
4
4
  "description": "MCP server for Notion API - Create, read, update pages and databases",
5
5
  "type": "module",
6
6
  "license": "MIT",