Skip to content
MCP Shelf

Pod to App: Claude Code

How to install the Notion MCP server in Claude Code

By Sophie Filer · Updated 10 Nov 2026 · Steps checked against Notion's own docs on 10 Nov 2026

The short answer

Run claude mcp add --transport http notion https://mcp.notion.com/mcp, then type /mcp inside Claude Code and sign in to Notion. It uses Notion's own hosted server, so there is no integration token to create.

Terminal
claude mcp add --transport http notion https://mcp.notion.com/mcp
Sign-in
Notion account in the browser
Runs on
Notion's hosted server
Plans
Every plan; not guests
Price
Free to connect

Before you start

  • A Notion account that is a member of the workspace. Workspace guests cannot connect.
  • Claude Code in a terminal. Decide whether you want Notion in one project or everywhere; the scope section below explains both.

Install it step by step

  1. Step 1: Run the command at the top of this page in your terminal.
  2. Step 2: Start Claude Code and type /mcp. Select notion and choose to authenticate.
  3. Step 3: A Notion page opens in your browser. Pick the workspace and allow access.
  4. Step 4: Back in Claude Code, /mcp should show notion as connected.
  5. Step 5: Try it on something real: "Find our onboarding doc in Notion and turn its checklist into a TODO.md in this repo."

Every project, or just this one

Add thisResult
nothing (the default)Notion only in the folder where you ran the command
--scope userNotion in every Claude Code session on your machine, the usual choice for a notes tool
--scope projectSaved to .mcp.json so the whole team gets it; each person still signs in with their own Notion

What Claude Code can do in Notion

  • Search across the pages and databases you can see, and read them in full.
  • Create pages, for example a write-up of the change you just made, in the right database.
  • Update existing pages and database entries, such as moving a task to Done.
  • Pull specs and decisions into the session before it starts coding, so the work matches what was agreed.

Without a browser: Notion MCP tokens

For scripts or a machine where nobody can sign in, Business and Enterprise workspaces can create an MCP token instead. Only workspace owners can make one. Claude Code sends it as a bearer header:

Terminal
claude mcp add --transport http notion https://mcp.notion.com/mcp -H "Authorization: Bearer YOUR_NOTION_MCP_TOKEN"

If it does not work

What you seeWhat to do
Sign-in fails or loopsIn /mcp, choose notion, clear authentication, and sign in again.
An error mentioning a workspace policyYour Enterprise admin has limited MCP access. Ask them to allow it.
Connected, but pages are missingYou can only reach pages your own Notion account can open. Guests cannot connect at all.
Your setup cannot reach the hosted URL directlyUse the bridge: claude mcp add notion -- npx -y mcp-remote https://mcp.notion.com/mcp.

MCP Shelf take

Is Notion worth adding to Claude Code?

Notion in Claude Code is less about writing code and more about keeping it tied to the team's thinking. The best uses we have seen are small and boring: reading the spec before starting, filing a short summary after a change, and ticking off the task. Add it with --scope user so it is always there. Do not expect it to replace a proper search of your codebase, and watch how much context long pages use. If your team does not keep specs in Notion, skip it.

Sophie Filer

Questions

Do I need a Notion API key for Claude Code?

No. The hosted server signs you in with your Notion account through the browser. Tokens are only an option on Business and Enterprise plans, for setups with no browser.

Is Notion MCP free?

Connecting works on every Notion plan, including free ones. What Claude Code can do inside Notion follows your normal workspace permissions and plan.

Should I use the Notion npm package or the hosted server?

The hosted server at mcp.notion.com. The npm package was the older local route, and Notion says it is no longer actively maintained.

How do I remove Notion from Claude Code?

Run claude mcp remove notion. If you added it with --scope user, add the same flag to the remove command.

Sources: the steps on this page are written in our own words from Notion's own install docs, the README. If they disagree with this page, the project's docs win; please tell us from the server page.