@notionhq/notion-mcp-server 1.6.0 → 1.8.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/README.md
CHANGED
|
@@ -19,7 +19,14 @@ For example, you can create a read-only integration token by giving only "Read c
|
|
|
19
19
|
|
|
20
20
|
|
|
21
21
|
|
|
22
|
-
#### 2.
|
|
22
|
+
#### 2. Connecting content to integration:
|
|
23
|
+
Ensure relevant pages and databases are connected to your integration.
|
|
24
|
+
|
|
25
|
+
To do this, you'll need to visit that page, and click on the 3 dots, and select "Connect to integration".
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
|
|
29
|
+
#### 3. Adding MCP config to your client:
|
|
23
30
|
|
|
24
31
|
##### Using npm:
|
|
25
32
|
Add the following to your `.cursor/mcp.json` or `claude_desktop_config.json` (MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`)
|
|
@@ -39,7 +46,41 @@ Add the following to your `.cursor/mcp.json` or `claude_desktop_config.json` (Ma
|
|
|
39
46
|
```
|
|
40
47
|
|
|
41
48
|
##### Using Docker:
|
|
42
|
-
|
|
49
|
+
|
|
50
|
+
There are two options for running the MCP server with Docker:
|
|
51
|
+
|
|
52
|
+
###### Option 1: Using the official Docker Hub image:
|
|
53
|
+
|
|
54
|
+
Add the following to your `.cursor/mcp.json` or `claude_desktop_config.json`:
|
|
55
|
+
|
|
56
|
+
```javascript
|
|
57
|
+
{
|
|
58
|
+
"mcpServers": {
|
|
59
|
+
"notionApi": {
|
|
60
|
+
"command": "docker",
|
|
61
|
+
"args": [
|
|
62
|
+
"run",
|
|
63
|
+
"--rm",
|
|
64
|
+
"-i",
|
|
65
|
+
"-e", "OPENAPI_MCP_HEADERS",
|
|
66
|
+
"mcp/notion"
|
|
67
|
+
],
|
|
68
|
+
"env": {
|
|
69
|
+
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
This approach:
|
|
77
|
+
- Uses the official Docker Hub image
|
|
78
|
+
- Properly handles JSON escaping via environment variables
|
|
79
|
+
- Provides a more reliable configuration method
|
|
80
|
+
|
|
81
|
+
###### Option 2: Building the Docker image locally:
|
|
82
|
+
|
|
83
|
+
You can also build and run the Docker image locally. First, build the Docker image:
|
|
43
84
|
|
|
44
85
|
```bash
|
|
45
86
|
docker-compose build
|
|
@@ -58,7 +99,7 @@ Then, add the following to your `.cursor/mcp.json` or `claude_desktop_config.jso
|
|
|
58
99
|
"-i",
|
|
59
100
|
"-e",
|
|
60
101
|
"OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\"}",
|
|
61
|
-
"notion-mcp-server
|
|
102
|
+
"notion-mcp-server"
|
|
62
103
|
]
|
|
63
104
|
}
|
|
64
105
|
}
|
|
@@ -69,13 +110,6 @@ Don't forget to replace `ntn_****` with your integration secret. Find it from yo
|
|
|
69
110
|
|
|
70
111
|
|
|
71
112
|
|
|
72
|
-
#### 3. Connecting content to integration:
|
|
73
|
-
Ensure relevant pages and databases are connected to your integration.
|
|
74
|
-
|
|
75
|
-
To do this, you'll need to visit that page, and click on the 3 dots, and select "Connect to integration".
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
113
|
### Examples
|
|
80
114
|
|
|
81
115
|
1. Using the following instruction
|