@atikk-co-jp/notion-mcp-server 0.10.1 → 0.10.2

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 (3) hide show
  1. package/README.ja.md +77 -67
  2. package/README.md +50 -56
  3. package/package.json +1 -1
package/README.ja.md CHANGED
@@ -29,6 +29,56 @@ Notionのタスクデータベースから、特定の条件でタスクを取
29
29
 
30
30
  **このリポジトリは、`fields`パラメータによる90%のトークン削減と共にプロパティフィルタを提供します。**
31
31
 
32
+ ## クイックスタート
33
+
34
+ ### 1. Notionトークンを取得
35
+
36
+ 1. [Notion Integrations](https://www.notion.so/my-integrations)にアクセス
37
+ 2. 「新しいインテグレーション」をクリック
38
+ 3. 名前を入力し、ワークスペースを選択
39
+ 4. 「内部インテグレーションシークレット」をコピー（`ntn_`で始まる）
40
+ 5. アクセスしたいページ/データベースをインテグレーションと共有
41
+
42
+ ### 2. AIクライアントを設定
43
+
44
+ #### Claude Desktop
45
+
46
+ 設定ファイル（macOSの場合: `~/.config/claude/claude_desktop_config.json`）に追加:
47
+
48
+ ```json
49
+ {
50
+ "mcpServers": {
51
+ "notion": {
52
+ "command": "npx",
53
+ "args": ["-y", "@atikk-co-jp/notion-mcp-server"],
54
+ "env": {
55
+ "NOTION_TOKEN": "ntn_xxxxxxxxxxxx"
56
+ }
57
+ }
58
+ }
59
+ }
60
+ ```
61
+
62
+ #### Claude Code
63
+
64
+ `.mcp.json`に追加:
65
+
66
+ ```json
67
+ {
68
+ "mcpServers": {
69
+ "notion": {
70
+ "command": "npx",
71
+ "args": ["-y", "@atikk-co-jp/notion-mcp-server"],
72
+ "env": {
73
+ "NOTION_TOKEN": "ntn_xxxxxxxxxxxx"
74
+ }
75
+ }
76
+ }
77
+ }
78
+ ```
79
+
80
+ 以上です！AIクライアントを再起動して、Notionの操作を始めましょう。
81
+
32
82
  ## 特徴
33
83
 
34
84
  - **ページ操作**: Notionページの作成、取得、更新、移動
@@ -87,62 +137,6 @@ Notionのタスクデータベースから、特定の条件でタスクを取
87
137
  | **検索** | | | | |
88
138
  | | [Search](https://developers.notion.com/reference/post-search) | `search` | JSON | **simple**/json |
89
139
 
90
- ## インストール
91
-
92
- ```bash
93
- npm install @atikk-co-jp/notion-mcp-server
94
- # または
95
- pnpm add @atikk-co-jp/notion-mcp-server
96
- # または
97
- yarn add @atikk-co-jp/notion-mcp-server
98
- ```
99
-
100
- ## 使い方
101
-
102
- ### Claude Desktopで使用する
103
-
104
- Claude Desktopの設定ファイル（macOSの場合: `~/.config/claude/claude_desktop_config.json`）に追加:
105
-
106
- ```json
107
- {
108
- "mcpServers": {
109
- "notion": {
110
- "command": "npx",
111
- "args": ["-y", "@atikk-co-jp/notion-mcp-server"],
112
- "env": {
113
- "NOTION_TOKEN": "your-notion-integration-token"
114
- }
115
- }
116
- }
117
- }
118
- ```
119
-
120
- ### Claude Codeで使用する
121
-
122
- `.mcp.json`に追加:
123
-
124
- ```json
125
- {
126
- "mcpServers": {
127
- "notion": {
128
- "command": "npx",
129
- "args": ["-y", "@atikk-co-jp/notion-mcp-server"],
130
- "env": {
131
- "NOTION_TOKEN": "your-notion-integration-token"
132
- }
133
- }
134
- }
135
- }
136
- ```
137
-
138
- ## Notionトークンの取得方法
139
-
140
- 1. [Notion Integrations](https://www.notion.so/my-integrations)にアクセス
141
- 2. 「新しいインテグレーション」をクリック
142
- 3. 名前を入力し、ワークスペースを選択
143
- 4. 「内部インテグレーションシークレット」をコピー（`ntn_`で始まる）
144
- 5. アクセスしたいページ/データベースをインテグレーションと共有
145
-
146
140
  ## 利用可能なツール
147
141
 
148
142
  ### retrieve-page
@@ -431,17 +425,6 @@ Markdownを使ってブロックを追加します。`append-block-children`と
431
425
  | append-block-children (ブロック構造) | ~201 | - |
432
426
  | append-blocks-simple (Markdown) | ~42 | **79%** |
433
427
 
434
- ### create-comment
435
-
436
- ページにコメントを追加します。
437
-
438
- ```json
439
- {
440
- "page_id": "ページのUUID",
441
- "rich_text": [{ "type": "text", "text": { "content": "これはコメントです" } }]
442
- }
443
- ```
444
-
445
428
  ### replace-page-content ⭐
446
429
 
447
430
  ページの全コンテンツをMarkdownで置換します。`child_database`と`child_page`ブロックは自動的に保護されます（削除されません）。
@@ -507,6 +490,33 @@ Markdownを使ってブロックを追加します。`append-block-children`と
507
490
 
508
491
  **対象ブロックタイプ:** paragraph, heading_1/2/3, bulleted_list_item, numbered_list_item, to_do, quote, callout, toggle
509
492
 
493
+ ### create-comment
494
+
495
+ ページにコメントを追加します。
496
+
497
+ ```json
498
+ {
499
+ "page_id": "ページのUUID",
500
+ "rich_text": [{ "type": "text", "text": { "content": "これはコメントです" } }]
501
+ }
502
+ ```
503
+
504
+ ### create-comment-simple ⭐
505
+
506
+ Markdownを使ってコメントを追加します。`create-comment`より簡単。
507
+
508
+ **パラメータ:**
509
+ - `page_id` (必須): ページのID
510
+ - `content` (必須): コメント内容（Markdown形式）
511
+ - `discussion_id` (任意): 既存スレッドへの返信
512
+
513
+ ```json
514
+ {
515
+ "page_id": "ページのUUID",
516
+ "content": "これは**重要**で[リンク](https://example.com)もあります"
517
+ }
518
+ ```
519
+
510
520
  ## 開発
511
521
 
512
522
  ```bash
package/README.md CHANGED
@@ -29,6 +29,56 @@ Here's what I found with existing options:
29
29
 
30
30
  **This repository provides property filtering with `fields` parameter for 90% token reduction.**
31
31
 
32
+ ## Quick Start
33
+
34
+ ### 1. Get a Notion Token
35
+
36
+ 1. Go to [Notion Integrations](https://www.notion.so/my-integrations)
37
+ 2. Click "New integration"
38
+ 3. Give it a name and select the workspace
39
+ 4. Copy the "Internal Integration Token" (starts with `ntn_`)
40
+ 5. Share the pages/databases you want to access with your integration
41
+
42
+ ### 2. Configure Your AI Client
43
+
44
+ #### Claude Desktop
45
+
46
+ Add to your configuration (`~/.config/claude/claude_desktop_config.json` on macOS):
47
+
48
+ ```json
49
+ {
50
+ "mcpServers": {
51
+ "notion": {
52
+ "command": "npx",
53
+ "args": ["-y", "@atikk-co-jp/notion-mcp-server"],
54
+ "env": {
55
+ "NOTION_TOKEN": "ntn_xxxxxxxxxxxx"
56
+ }
57
+ }
58
+ }
59
+ }
60
+ ```
61
+
62
+ #### Claude Code
63
+
64
+ Add to your `.mcp.json`:
65
+
66
+ ```json
67
+ {
68
+ "mcpServers": {
69
+ "notion": {
70
+ "command": "npx",
71
+ "args": ["-y", "@atikk-co-jp/notion-mcp-server"],
72
+ "env": {
73
+ "NOTION_TOKEN": "ntn_xxxxxxxxxxxx"
74
+ }
75
+ }
76
+ }
77
+ }
78
+ ```
79
+
80
+ That's it! Restart your AI client and start using Notion.
81
+
32
82
  ## Features
33
83
 
34
84
  - **Page Operations**: Create, retrieve, update, and move Notion pages
@@ -86,62 +136,6 @@ Here's what I found with existing options:
86
136
  | **Search** | | | | |
87
137
  | | [Search](https://developers.notion.com/reference/post-search) | `search` | JSON | **simple**/json |
88
138
 
89
- ## Installation
90
-
91
- ```bash
92
- npm install @atikk-co-jp/notion-mcp-server
93
- # or
94
- pnpm add @atikk-co-jp/notion-mcp-server
95
- # or
96
- yarn add @atikk-co-jp/notion-mcp-server
97
- ```
98
-
99
- ## Usage
100
-
101
- ### With Claude Desktop
102
-
103
- Add to your Claude Desktop configuration (`~/.config/claude/claude_desktop_config.json` on macOS):
104
-
105
- ```json
106
- {
107
- "mcpServers": {
108
- "notion": {
109
- "command": "npx",
110
- "args": ["-y", "@atikk-co-jp/notion-mcp-server"],
111
- "env": {
112
- "NOTION_TOKEN": "your-notion-integration-token"
113
- }
114
- }
115
- }
116
- }
117
- ```
118
-
119
- ### With Claude Code
120
-
121
- Add to your `.mcp.json`:
122
-
123
- ```json
124
- {
125
- "mcpServers": {
126
- "notion": {
127
- "command": "npx",
128
- "args": ["-y", "@atikk-co-jp/notion-mcp-server"],
129
- "env": {
130
- "NOTION_TOKEN": "your-notion-integration-token"
131
- }
132
- }
133
- }
134
- }
135
- ```
136
-
137
- ## Getting a Notion Token
138
-
139
- 1. Go to [Notion Integrations](https://www.notion.so/my-integrations)
140
- 2. Click "New integration"
141
- 3. Give it a name and select the workspace
142
- 4. Copy the "Internal Integration Token" (starts with `ntn_`)
143
- 5. Share the pages/databases you want to access with your integration
144
-
145
139
  ## Available Tools
146
140
 
147
141
  ### retrieve-page
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@atikk-co-jp/notion-mcp-server",
3
- "version": "0.10.1",
3
+ "version": "0.10.2",
4
4
  "description": "MCP server for Notion API - Create, read, update pages and databases",
5
5
  "type": "module",
6
6
  "license": "MIT",