Skip to content

Notion MCP and API

Notion lets authorized applications read and change pages, databases and content in a workspace. An agent can find workspace pages, read page information and move pages to trash. Connect your Notion account once with OAuth in Longwave; agents act only on that account.

Add to Longwave

Install elsewhere

Install Notion

Choose a harness. These instructions connect to the hosted MCP endpoint shown on this page.

Claude Code

Run this in your terminal. It adds a user-scoped server; use --scope project instead if it should apply only to the current project.

terminal
claude mcp add --scope user --transport http notion https://mcp.notion.com/mcp
access
Connect account

Use Notion on Longwave

  1. Download Longwave or open app.longwave.run.
  2. Sign in to Notion the first time an agent uses the server.
  3. Ask for the result in any thread, for example: “Find a project page in a workspace”. The agent picks the Notion function and calls it.

Use cases

Questions people ask

Does Notion API search read full page text?

Search matches page and data source titles. It does not search the full text inside page blocks. Notion documentation

What are the Notion API rate limits?

Notion allows 180 requests per minute per connection on most plans and 600 on Business and Enterprise. Workspace limits and endpoint limits also apply. Requests over a limit return HTTP 429 with Retry-After. Notion documentation

How do I add the Notion MCP server to Claude Code?

Run claude mcp add --transport http notion https://mcp.notion.com/mcp in a terminal. Sign in to Notion the first time an agent uses the server.

Who publishes the Notion MCP server?

Notion publishes the Notion MCP server that Longwave installs.

Use Notion in Longwave

Call Notion from any agent thread, on your machine or in the cloud.

Add to Longwave