@n24q02m/better-notion-mcp 2.23.0 → 2.24.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 (47) hide show
  1. package/README.md +5 -80
  2. package/bin/cli.mjs +13 -12
  3. package/build/src/main.d.ts +12 -0
  4. package/build/src/main.d.ts.map +1 -1
  5. package/build/src/main.js +36 -7
  6. package/build/src/main.js.map +1 -1
  7. package/build/src/main.test.js +55 -21
  8. package/build/src/main.test.js.map +1 -1
  9. package/build/src/relay-schema.test.d.ts +2 -0
  10. package/build/src/relay-schema.test.d.ts.map +1 -0
  11. package/build/src/relay-schema.test.js +20 -0
  12. package/build/src/relay-schema.test.js.map +1 -0
  13. package/build/src/relay-setup.d.ts.map +1 -1
  14. package/build/src/relay-setup.js +16 -7
  15. package/build/src/relay-setup.js.map +1 -1
  16. package/build/src/relay-setup.test.js +38 -51
  17. package/build/src/relay-setup.test.js.map +1 -1
  18. package/build/src/tools/composite/comments.d.ts.map +1 -1
  19. package/build/src/tools/composite/comments.js +16 -2
  20. package/build/src/tools/composite/comments.js.map +1 -1
  21. package/build/src/tools/composite/comments.test.js +23 -6
  22. package/build/src/tools/composite/comments.test.js.map +1 -1
  23. package/build/src/tools/composite/databases.d.ts +4 -0
  24. package/build/src/tools/composite/databases.d.ts.map +1 -1
  25. package/build/src/tools/composite/databases.js +55 -47
  26. package/build/src/tools/composite/databases.js.map +1 -1
  27. package/build/src/tools/composite/databases.test.js +3 -1
  28. package/build/src/tools/composite/databases.test.js.map +1 -1
  29. package/build/src/tools/composite/file-uploads.js +5 -5
  30. package/build/src/tools/composite/file-uploads.js.map +1 -1
  31. package/build/src/tools/helpers/id.test.js +4 -0
  32. package/build/src/tools/helpers/id.test.js.map +1 -1
  33. package/build/src/tools/helpers/pagination.d.ts +14 -2
  34. package/build/src/tools/helpers/pagination.d.ts.map +1 -1
  35. package/build/src/tools/helpers/pagination.js +65 -41
  36. package/build/src/tools/helpers/pagination.js.map +1 -1
  37. package/build/src/tools/helpers/pagination.test.js +28 -1
  38. package/build/src/tools/helpers/pagination.test.js.map +1 -1
  39. package/build/src/tools/helpers/security.test.js +22 -6
  40. package/build/src/tools/helpers/security.test.js.map +1 -1
  41. package/build/src/transports/http.d.ts.map +1 -1
  42. package/build/src/transports/http.js +15 -3
  43. package/build/src/transports/http.js.map +1 -1
  44. package/build/src/transports/http.test.js +37 -2
  45. package/build/src/transports/http.test.js.map +1 -1
  46. package/build/tsconfig.tsbuildinfo +1 -1
  47. package/package.json +3 -3
package/README.md CHANGED
@@ -30,89 +30,14 @@ mcp-name: io.github.n24q02m/better-notion-mcp
30
30
  - **Tiered token optimization** -- ~77% reduction via compressed descriptions + on-demand `help` tool
31
31
  - **Dual transport** -- local stdio (token) or remote HTTP (OAuth 2.1, no token needed)
32
32
 
33
- ## Quick Start
33
+ ## Setup
34
34
 
35
- ### Claude Code Plugin (Recommended)
35
+ **With AI Agent** -- copy and send this to your AI agent:
36
36
 
37
- Via marketplace (includes skills: /organize-database, /bulk-update):
37
+ > Please set up @n24q02m/better-notion-mcp for me. Follow this guide:
38
+ > https://raw.githubusercontent.com/n24q02m/better-notion-mcp/main/docs/setup-with-agent.md
38
39
 
39
- ```bash
40
- /plugin marketplace add n24q02m/claude-plugins
41
- /plugin install better-notion-mcp@n24q02m-plugins
42
- ```
43
-
44
-
45
-
46
- Plugin uses remote OAuth — no `NOTION_TOKEN` needed. Browser opens for Notion authorization on first use.
47
-
48
- ### Codex CLI
49
-
50
- Add to `~/.codex/config.toml`:
51
-
52
- ```toml
53
- [mcp_servers.better-notion-mcp]
54
- command = "npx"
55
- args = ["-y", "@n24q02m/better-notion-mcp"]
56
- ```
57
-
58
- ### MCP Server
59
-
60
- #### Option 1: Remote (OAuth) -- No token needed
61
-
62
- Connect directly via URL with OAuth authentication. Your MCP client handles the OAuth flow automatically.
63
-
64
- ```jsonc
65
- {
66
- "mcpServers": {
67
- "better-notion": {
68
- "type": "http",
69
- "url": "https://better-notion-mcp.n24q02m.com/mcp"
70
- }
71
- }
72
- }
73
- ```
74
-
75
- #### Option 2: npx
76
-
77
- Get your token: <https://www.notion.so/my-integrations> -> Create integration -> Copy token -> Share pages
78
-
79
- Set `NOTION_TOKEN` in `~/.claude/settings.local.json` or your shell profile:
80
-
81
- ```bash
82
- export NOTION_TOKEN="ntn_..."
83
- ```
84
-
85
- Then add to your MCP client config:
86
-
87
- ```jsonc
88
- {
89
- "mcpServers": {
90
- "better-notion": {
91
- "command": "npx",
92
- "args": ["-y", "@n24q02m/better-notion-mcp@latest"]
93
- }
94
- }
95
- }
96
- ```
97
-
98
- Other runners: `bun x`, `pnpm dlx`, `yarn dlx` also work.
99
-
100
- #### Option 3: Docker
101
-
102
- ```jsonc
103
- {
104
- "mcpServers": {
105
- "better-notion": {
106
- "command": "docker",
107
- "args": [
108
- "run", "-i", "--rm",
109
- "-e", "NOTION_TOKEN",
110
- "n24q02m/better-notion-mcp:latest"
111
- ]
112
- }
113
- }
114
- }
115
- ```
40
+ **Manual Setup** -- follow [docs/setup-manual.md](docs/setup-manual.md)
116
41
 
117
42
  ## Tools
118
43