Skip to content
ToolCargo

Notion

Live

Search and read pages in a Notion workspace you already use.

Paste an internal integration token. Then search pages, read a page as text, or list database rows. Does not create or edit pages. Only api.notion.com is contacted. The integration only sees pages it was invited to.

Server URL

streamable http
https://toolcargo.com/mcp/notion

Claude Code

terminal
claude mcp add --transport http --scope user toolcargo-notion https://toolcargo.com/mcp/notion \
  --header "Authorization: Bearer YOUR_API_KEY"

Create a key in your dashboard. Other clients: setup guides.

What it helps you do

  • Search pages and databases by title
  • Read a page as plain text
  • List database rows

Built for: Teams whose briefs and wikis already live in Notion.

Example requests

Find a brief

“With ToolCargo, search Notion for “Q4 campaign brief”.”

Matching pages the integration can see, with ids.

Read it

“Read that Notion page.”

Title and top-level blocks as text.

Step-by-step workflows: pre-launch check · fixing link previews

Tools

ToolWhat it doesAccess
search_pages
Search pages
Pages and databases matching a query in the connected workspace. The integration only sees pages it was invited to.Read-only
read_page
Read a page
Page title and top-level blocks as plain text (capped). Nested blocks are not expanded.Read-only
query_database
Query a database
Rows from a Notion database, optional text match on titles.Read-only

Requirements

  • • A ToolCargo account with Site Audit activated (free).
  • • A Notion internal integration token, invited to the pages you need.

Limitations

  • • Read-only. Does not create, edit or comment.
  • • Pages the integration was not invited to are invisible.
  • • Nested blocks are not expanded. Page text is capped.
  • • The token is stored encrypted. Disconnect deletes it.

Supported clients

“Tested” means we connected that client to this endpoint and ran a tool call ourselves. “Documented” means the client supports this setup per its own docs, but we have not tested it yet.

Claude CodeAPI key headerTestedRemote HTTP server with an Authorization header. Tested 2026-09-11 (v2.1.268).
Claude (claude.ai)OAuth sign-inTestedCustom connector with OAuth sign-in; tested on claude.ai web 2026-09-11. Desktop and mobile use the same account connectors but were not tested separately.
CursorAPI key headerDocumented, not yet testedmcp.json with url and headers.
VS Code (Copilot agent mode)API key headerDocumented, not yet tested.vscode/mcp.json with type http and headers.
ChatGPT (developer mode)OAuth sign-inDocumented, not yet testedRequires OAuth; API keys cannot be entered.
MCP InspectorAPI key headerTestedCLI mode, tested 2026-09-11. Useful for calling tools directly.

Pricing

Free

$0

For trying the connector on your own sites.

50 calls/month · 25 links per check

Pro

$12/mo

For freelancers and agencies auditing client sites every week.

2,000 calls/month · 100 links per check

Proposed test price. See the pricing page for checkout status.

Full pricing and billing details