Connection check
local install
better-notion-mcp
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.
Tools
13
GitHub stars
36
Installs / wk
—
Licence
Apache-2.0
Transport
stdio
Last checked
never
Tools & capabilities
13 toolsRead from the published package source — this server runs locally, so there is no endpoint to query. Names are taken from the code, not observed at runtime, and descriptions are often absent.
blocks
from source
Read and modify block-level content within pages. Actions (required params -> optional): - get (block_id): retrieve single block - children (block_id): list child blocks - append… Read and modify block-level content within pages. Actions (required params -> optional): - get (block_id): retrieve single block - children (block_id): list child blocks - append (block_id, content -> position, after_block_id): add markdown content at position - update (block_id, content): replace text block content - delete (block_id): remove block Use \
comments
from source
Manage page comments. Actions (required params -> optional): - list (page_id): all comments on a page - get (comment_id): single comment - create (content -> page_id for new discu… Manage page comments. Actions (required params -> optional): - list (page_id): all comments on a page - get (comment_id): single comment - create (content -> page_id for new discussion, discussion_id for reply)
config
from source
config__open_relay
from source
Open the relay configuration form for better-notion-mcp in the user browser. Returns the relay URL, whether the browser launched, and the current credential state. Open the relay configuration form for better-notion-mcp in the user browser. Returns the relay URL, whether the browser launched, and the current credential state.
content_convert
from source
databases
from source
file_uploads
from source
Upload files to Notion. Actions (required params -> optional): - create (filename -> content_type, mode= Upload files to Notion. Actions (required params -> optional): - create (filename -> content_type, mode=
help
from source
Get full documentation for a tool. Use when compressed descriptions are insufficient. Get full documentation for a tool. Use when compressed descriptions are insufficient.
nonexistent_tool
from source
page
from source
pages
from source
users
from source
Get user information. Actions (required params): - list: all workspace users (requires admin permissions) - get (user_id): single user info - me: current bot/integration user - fr… Get user information. Actions (required params): - list: all workspace users (requires admin permissions) - get (user_id): single user info - me: current bot/integration user - from_workspace: extract users from accessible pages (use if list fails)
workspace
from source