Notion MCP: Documentation
Updated:
Connection
Remote: https://mcp.notion.com/mcp (OAuth, approved right in the client UI). Permissions match the authorizing user.
Tools
notion-search— search across the workspace and connected sources (Slack, Google Drive, Jira).notion-fetch— retrieve content from a page, database or data source by URL/ID.notion-create-pages/notion-update-page/notion-move-pages/notion-duplicate-page— create, update, move and duplicate pages.notion-create-database/notion-update-data-source— create and update databases.notion-create-view/notion-update-view— create and edit database views.notion-query-data-sources— query a data source via SQL or an existing view.notion-query-database-view— fetch data using a predefined view's filters and sorts.notion-query-meeting-notes— search the current user's meeting notes.notion-create-comment/notion-get-comments— page comments.notion-get-teams/notion-get-users— workspace teamspaces and members.notion-get-async-task— status of a background job (duplication and other long-running operations).
Agent flow
"Assemble a project status page from tasks in this database", "find last year's notes on X and summarize".
Limits
Available on every Notion plan, including Free. Standard Notion API rate limit applies — roughly 3 requests/second (~180/min) average per integration; exceeding it returns HTTP 429.