Notion for your AI agent

Give Claude Code, Cursor, Codex or your own agent Notion through one MCP URL and one key. Your team signs in to Notion once and the agent never holds a token. Reads run at once; anything that changes Notion waits for your approval.

Get your key Read the docs

57: Notion actions your agent gets as tools
1 URL: one endpoint, one key per agent
60/min: calls per key, hard caps on top
0: Notion credentials inside your agent

Actions

What your agent can do in Notion

A sample of the 57 actions. Your agent sees the full list with tools/list.

Reads · run at once

Fetch All Notion Block Contents
Fetch Notion Block Children
Fetch Notion block metadata
Fetch comments
Fetch Notion Data
Fetch Database
Fetch database row
Get About Me (Deprecated)

Writes · wait for your approval

Add multiple content blocks (bulk, user-friendly)
Add single content block to Notion page (Deprecated)
Append raw Notion blocks (advanced API)
Append code blocks (code, quote, equation)
Append layout blocks (divider, TOC, columns)
Append media blocks (image, video, audio, files)
Append table blocks
Append task blocks (to-do, toggle, callout)

Quickstart

Connect Notion to your agent in two minutes

Create your account and connect Notion with its normal sign-in page.
Open Developers and create an agent key (you can limit it to Notion).
Add the server to your client:

Claude Code · Terminal

claude mcp add --transport http vellarin https://hub.vellarin.ai/api/hub/mcp --header "Authorization: Bearer <key>"

Cursor · ~/.cursor/mcp.json (or .cursor/mcp.json in a project)

{
  "mcpServers": {
    "vellarin": {
      "url": "https://hub.vellarin.ai/api/hub/mcp",
      "headers": {
        "Authorization": "Bearer ${env:VELLARIN_HUB_KEY}"
      }
    }
  }
}

Codex · ~/.codex/config.toml

[mcp_servers.vellarin]
url = "https://hub.vellarin.ai/api/hub/mcp"
bearer_token_env_var = "VELLARIN_HUB_KEY"

Questions

Notion and AI agents

How do I connect Notion to Claude Code, Cursor or Codex?

Create a free Vellarin account, connect Notion with its normal sign-in, create an agent key on the Developers page and add the Vellarin Hub MCP server to your client with one line. Your agent then sees the Notion actions as tools.

Can my agent change things in Notion without asking me?

No. Read actions run at once. Any action that sends, creates, changes or deletes something in Notion waits for the workspace owner's approval and then runs exactly once.

Does my agent get my Notion password or token?

No. The sign-in lives on the server side. Your agent holds only a Vellarin Hub key, which you can scope to Notion alone, cap per day and per month, and revoke at any moment.

What does it cost?

Hub Free includes 500 app calls a month and 1 agent key, with no card. Over the cap the answer is "upgrade or wait", never a charge.