|
2 | 2 |
|
3 | 3 | MCP Server for the Notion API, enabling Claude to interact with Notion workspaces.
|
4 | 4 |
|
| 5 | +## Setup |
| 6 | + |
| 7 | +Here is a detailed explanation of the steps mentioned above in the following articles: |
| 8 | + |
| 9 | +- English Version: https://dev.to/suekou/operating-notion-via-claude-desktop-using-mcp-c0h |
| 10 | +- Japanese Version: https://qiita.com/suekou/items/44c864583f5e3e6325d9 |
| 11 | + |
| 12 | +1. **Create a Notion Integration**: |
| 13 | + |
| 14 | + - Visit the [Notion Your Integrations page](https://www.notion.so/profile/integrations). |
| 15 | + - Click "New Integration". |
| 16 | + - Name your integration and select appropriate permissions (e.g., "Read content", "Update content"). |
| 17 | + |
| 18 | +2. **Retrieve the Secret Key**: |
| 19 | + |
| 20 | + - Copy the "Internal Integration Token" from your integration. |
| 21 | + - This token will be used for authentication. |
| 22 | + |
| 23 | +3. **Add the Integration to Your Workspace**: |
| 24 | + |
| 25 | + - Open the page or database you want the integration to access in Notion. |
| 26 | + - Click the navigation button in the top right corner. |
| 27 | + - Click "Connect to" button and select your integration. |
| 28 | + |
| 29 | +4. **Configure Claude Desktop**: |
| 30 | + Add the following to your `claude_desktop_config.json`: |
| 31 | + |
| 32 | + ```json |
| 33 | + { |
| 34 | + "mcpServers": { |
| 35 | + "notion": { |
| 36 | + "command": "node", |
| 37 | + "args": ["your-built-file-path"], |
| 38 | + "env": { |
| 39 | + "NOTION_API_TOKEN": "your-integration-token" |
| 40 | + } |
| 41 | + } |
| 42 | + } |
| 43 | + } |
| 44 | + ``` |
| 45 | + |
| 46 | +## Troubleshooting |
| 47 | + |
| 48 | +If you encounter permission errors: |
| 49 | + |
| 50 | +1. Ensure the integration has the required permissions. |
| 51 | +2. Verify that the integration is invited to the relevant pages or databases. |
| 52 | +3. Confirm the token and configuration are correctly set in `claude_desktop_config.json`. |
| 53 | + |
5 | 54 | ## Tools
|
6 | 55 |
|
7 | 56 | 1. `notion_append_block_children`
|
@@ -149,55 +198,6 @@ MCP Server for the Notion API, enabling Claude to interact with Notion workspace
|
149 | 198 | - `page_size` (number, max: 100): Number of comments to retrieve.
|
150 | 199 | - Returns: A paginated list of comments associated with the specified block or page.
|
151 | 200 |
|
152 |
| -## Setup |
153 |
| - |
154 |
| -Here is a detailed explanation of the steps mentioned above in the following articles: |
155 |
| - |
156 |
| -- English Version: https://dev.to/suekou/operating-notion-via-claude-desktop-using-mcp-c0h |
157 |
| -- Japanese Version: https://qiita.com/suekou/items/44c864583f5e3e6325d9 |
158 |
| - |
159 |
| -1. **Create a Notion Integration**: |
160 |
| - |
161 |
| - - Visit the [Notion Your Integrations page](https://www.notion.so/profile/integrations). |
162 |
| - - Click "New Integration". |
163 |
| - - Name your integration and select appropriate permissions (e.g., "Read content", "Update content"). |
164 |
| - |
165 |
| -2. **Retrieve the Secret Key**: |
166 |
| - |
167 |
| - - Copy the "Internal Integration Token" from your integration. |
168 |
| - - This token will be used for authentication. |
169 |
| - |
170 |
| -3. **Add the Integration to Your Workspace**: |
171 |
| - |
172 |
| - - Open the page or database you want the integration to access in Notion. |
173 |
| - - Click the navigation button in the top right corner. |
174 |
| - - Click "Connect to" button and select your integration. |
175 |
| - |
176 |
| -4. **Configure Claude Desktop**: |
177 |
| - Add the following to your `claude_desktop_config.json`: |
178 |
| - |
179 |
| - ```json |
180 |
| - { |
181 |
| - "mcpServers": { |
182 |
| - "notion": { |
183 |
| - "command": "node", |
184 |
| - "args": ["your-built-file-path"], |
185 |
| - "env": { |
186 |
| - "NOTION_API_TOKEN": "your-integration-token" |
187 |
| - } |
188 |
| - } |
189 |
| - } |
190 |
| - } |
191 |
| - ``` |
192 |
| - |
193 |
| -## Troubleshooting |
194 |
| - |
195 |
| -If you encounter permission errors: |
196 |
| - |
197 |
| -1. Ensure the integration has the required permissions. |
198 |
| -2. Verify that the integration is invited to the relevant pages or databases. |
199 |
| -3. Confirm the token and configuration are correctly set in `claude_desktop_config.json`. |
200 |
| - |
201 | 201 | ## License
|
202 | 202 |
|
203 | 203 | This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
|
0 commit comments