Arlet
Notion

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. 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. 2

    In your terminal, run claude mcp add --transport http arlet https://mcp.arlet.dev/mcp/ to add Arlet as an MCP server.

  3. 3

    Start Claude Code, run /mcp, select arlet and click Authenticate.

  4. 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-search

    Search pages and databases across the workspace by keyword or natural language.

  • notion-fetch

    Fetch the content of a page or database in a form the AI can read.

  • notion-create-pages

    Create new pages under a given parent page or database.

  • notion-update-page

    Update a page's body or properties.

  • notion-move-pages

    Move pages to a different parent page or database.

  • notion-duplicate-page

    Duplicate a page. Handy for starting from a template.

  • notion-create-database

    Create a new database and define its properties.

  • notion-update-data-source

    Add or change a database's properties (schema).

  • notion-create-comment

    Add a comment to a page.

  • notion-get-comments

    Read the comments on a page.

  • notion-get-users

    List 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

Use Notion with other AI clients