src ▸ site opened 0

Turn Notion into MCP tools

Give your AI agent Notion tools. Writ turns your Notion workflows into authenticated MCP tools your agent can call, taking real actions on your own account.

Writ runs on your own accounts, with your own credentials and data, on sites you are authorized to use.
claude_desktop_config.jsonMCP · writ-notion
json
{
  "mcpServers": {
    "writ-notion": {
      "url": "https://api.usewrit.app/mcp/your-workspace",
      "headers": { "Authorization": "Bearer wt_8f2c...a91" }
    }
  }
}
MCP server any client authenticated
new ▸ tool minted 01
02
create

No Notion MCP server yet? Build one in minutes

Record the Notion task once, or describe it to an AI session, and Writ turns it into an MCP tool your agent can call, taking real actions on your own Notion account.

  1. 1
    Record a Notion action once

    Open the recorder and open a page on Notion in a real browser. Writ captures the steps, login and 2FA included, into a workflow.

  2. 2
    Publish it as an MCP tool

    One click exposes the workflow as an MCP tool with a typed input schema, alongside a REST endpoint. Your agent picks it by its description.

  3. 3
    Call it from any MCP client

    Point Claude Desktop, Claude Code, Cursor, or any MCP client at your Writ server. The Notion tool acts on your own account and returns structured output.

Browse supported MCP clients, see what's possible on workflows, or search for another site. Free to start. See pricing.

gap ▸ no official mcp 02
03
why

Notion has no MCP server

Read-only website-to-MCP tools can summarize a Notion page, but they can't do anything on it. Writ turns the Notion workflows you build into MCP tools your agent calls to take real actions (search, extract, submit), authenticated, on your own Notion account.

Writ runs on your own accounts, with your own credentials and data, on sites you are authorized to use.

tools ▸ actions named 03
04
named tools

Notion tools your agent can call

Each tool is a real Notion workflow with a typed input schema and structured output. Your agent picks the right one by its description.

{ }notion.read_databaseReturn the rows of a database view.

Example tool schema

notion.read_database.jsonschema
json
{
  "name": "notion.read_database",
  "description": "Return the rows of a database view.",
  "input_schema": {
    "type": "object",
    "properties": {
      "query": { "type": "string", "description": "What to look up on Notion." }
    },
    "required": ["query"]
  }
}
wire ▸ any client 04
05
connect

Add the server to any MCP client

Copy the config into your client and authenticate with a wt_ key. Tools appear automatically.

Your key (wt_)
json
{
  "mcpServers": {
    "writ-notion": {
      "url": "https://api.usewrit.app/mcp/your-workspace",
      "headers": { "Authorization": "Bearer wt_8f2c...a91" }
    }
  }
}
Downstream caller (csk_)
json
{
  "mcpServers": {
    "writ-notion": {
      "url": "https://api.usewrit.app/mcp/your-workspace",
      "headers": { "Authorization": "Bearer csk_3a90...f4d" }
    }
  }
}
>_

Per-client setup. Step-by-step config for each client lives on the per-client pages: Claude Desktop, Claude Code, Cursor, Windsurf.

auth ▸ logged-in web 05
06
authenticated

Your agent acts on your own Notion account

Writ signs into your own Notion workspace through a Persona and runs inside that session.

PersonasTOTP & mailbox OTP Scoped wt_ / csk_ keysStructured output

Use Writ on your own Notion workspace. Authorized automation of your own account.

faq ▸ questions answered 07
08
faq

Notion MCP questions

Is there an official Notion MCP server?
Notion does not publish an MCP server. Writ lets you turn the Notion workflows you build (recorded, described, or discovered) into MCP tools your agent can call. They take real actions, not just read page text.
Are there ready-made Notion MCP tools I can install?
Record the Notion task once in the recorder, or describe it to an AI session, then publish it. Writ exposes it as both an MCP tool and a REST endpoint, usually in minutes.
How is this different from a read-only website-to-MCP tool?
Most website-to-MCP tools are readability crawlers that return page text. Writ tools act and transact: they log in, fill forms, click, extract, and complete multi-step Notion tasks, then return structured output your agent can use.
Does it work with Notion login and 2FA?
Writ signs into your own Notion workspace through a Persona and runs inside that session. Because each MCP tool is a real browser workflow, it runs inside your own authenticated Notion session, with TOTP and mailbox-OTP two-factor handled by Personas.
Which MCP clients can use these Notion tools?
Any MCP-compatible client: Claude Desktop, Claude Code, Cursor, Windsurf, and others. Point the client at your Writ MCP URL and authenticate with a wt_ key (or a csk_ consumer key for downstream callers).
Is it allowed to use Notion this way?
Use Writ on your own Notion workspace. Authorized automation of your own account. Writ runs on your own accounts, with your own credentials and data, on sites you are authorized to use.
rec ▸ ready

Give your agent Notion tools

Build a workflow, publish it as an MCP tool, and call it from any MCP client. Get started free.