Connect Notion to Claude Code
Search, read and write Notion from Claude Code. Arlet links the two through one MCP connection and takes care of keys and authentication.
Arlet makes Notion's official MCP server available from the AI client you already use. There is no integration to create on the Notion side. Signing in completes the connection.
Beyond searching and reading pages, the AI can create pages, update databases and leave comments. The available tools are exactly those provided by Notion's official server.
How to connect Notion to Claude Code
- 1
In the Arlet dashboard, open Integrations β Add an integration and choose Notion. Sign in with Link Notion, name the connection and click Create.
- 2
In your terminal, run claude mcp add --transport http arlet https://mcp.arlet.dev/mcp/ to add Arlet as an MCP server.
- 3
Start Claude Code, run /mcp, select arlet and click Authenticate.
- 4
Your browser opens. Sign in with Google and click Allow on the consent screen. The connection is complete.
The connection is per user and works across every project on the same machine.
What you can do
Notion tools that Claude Code can call.
notion-searchSearch pages and databases across the workspace by keyword or natural language.
notion-fetchFetch the content of a page or database in a form the AI can read.
notion-create-pagesCreate new pages under a given parent page or database.
notion-update-pageUpdate a page's body or properties.
notion-move-pagesMove pages to a different parent page or database.
notion-duplicate-pageDuplicate a page. Handy for starting from a template.
notion-create-databaseCreate a new database and define its properties.
notion-update-data-sourceAdd or change a database's properties (schema).
notion-create-commentAdd a comment to a page.
notion-get-commentsRead the comments on a page.
notion-get-usersList workspace members, for example to assign owners.
The tool list follows what Notion's official MCP server provides and may change.
Example uses
Turn meeting notes into tasks
Read a meeting-notes page, pull out decisions and action items, and register them in the task database with owners.
Ask questions about a spec
Search and summarize long specs or knowledge pages, and answer questions like "what are the constraints of this feature?" while citing the relevant section.
Compile the weekly report
Gather pages and tasks updated this week and create a new weekly-report page in your standard format.
Clean up a database
Find inconsistent values and empty properties, fill them in, and add new properties when needed.
Prompts you can use as-is
- Search Notion for "Product spec" and summarize the recent changes in five lines
- From today's meeting-notes page, extract decisions and to-dos and register them in the task DB with owners
- Collect the Notion pages updated this week and create a weekly report page in the usual format
- In the customer database, find rows with an empty Industry and fill it in from the company name
