@alfe.ai/notion-mcp 0.3.16 → 0.3.17
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 +25 -4
- package/dist/server.cjs +804 -0
- package/dist/server.d.cts +95 -0
- package/dist/server.d.ts +95 -1
- package/dist/server.js +758 -248
- package/package.json +11 -8
package/README.md
CHANGED
|
@@ -1,8 +1,12 @@
|
|
|
1
1
|
# @alfe.ai/notion-mcp
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
A runtime-agnostic stdio MCP proxy that connects Alfe agents to one or more
|
|
4
|
+
Notion workspaces through the official Notion MCP server.
|
|
4
5
|
|
|
5
|
-
|
|
6
|
+
The proxy requires an explicit `workspaceId` on every credential-touching tool,
|
|
7
|
+
keeps OAuth tokens out of tool results and child logs, and starts one pinned
|
|
8
|
+
official child per usable workspace. It also bounds child traffic and requires
|
|
9
|
+
target-matching confirmation for block/page deletion operations.
|
|
6
10
|
|
|
7
11
|
## Install
|
|
8
12
|
|
|
@@ -10,7 +14,24 @@ Part of [**Alfe**](https://alfe.ai) — the operating system for AI agents: buil
|
|
|
10
14
|
npm install @alfe.ai/notion-mcp
|
|
11
15
|
```
|
|
12
16
|
|
|
17
|
+
The executable is `notion-mcp-proxy`. Alfe normally installs and configures it
|
|
18
|
+
through the Notion integration manifest; it expects agent API configuration at
|
|
19
|
+
startup rather than a Notion token in the parent environment.
|
|
20
|
+
|
|
21
|
+
## Multi-workspace behavior
|
|
22
|
+
|
|
23
|
+
Call `notion_list_accounts` first and pass one returned `workspaceId` to every
|
|
24
|
+
other tool. `notion_check_connection` validates a selected connection without
|
|
25
|
+
returning the Notion user profile. Connecting another workspace requires a
|
|
26
|
+
daemon restart so the child pool can be rebuilt.
|
|
27
|
+
|
|
28
|
+
Destructive calls require an additional exact target confirmation:
|
|
29
|
+
|
|
30
|
+
- `API-delete-a-block`: `confirmBlockId` equals `block_id`
|
|
31
|
+
- archival `API-update-a-block`: `confirmBlockId` equals `block_id`
|
|
32
|
+
- trash/archive `API-patch-page`: `confirmPageId` equals `page_id`
|
|
33
|
+
|
|
13
34
|
## Links
|
|
14
35
|
|
|
15
|
-
-
|
|
16
|
-
-
|
|
36
|
+
- [Alfe](https://alfe.ai)
|
|
37
|
+
- [Documentation](https://docs.alfe.ai)
|