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.
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
- Step 1: Run the command at the top of this page in your terminal.
- Step 2: Start Claude Code and type
/mcp. Select notion and choose to authenticate. - Step 3: A Notion page opens in your browser. Pick the workspace and allow access.
- Step 4: Back in Claude Code,
/mcpshould show notion as connected. - 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 this | Result |
|---|---|
| nothing (the default) | Notion only in the folder where you ran the command |
--scope user | Notion in every Claude Code session on your machine, the usual choice for a notes tool |
--scope project | Saved 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:
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 see | What to do |
|---|---|
| Sign-in fails or loops | In /mcp, choose notion, clear authentication, and sign in again. |
| An error mentioning a workspace policy | Your Enterprise admin has limited MCP access. Ask them to allow it. |
| Connected, but pages are missing | You can only reach pages your own Notion account can open. Guests cannot connect at all. |
| Your setup cannot reach the hosted URL directly | Use 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.