# Connect Notion to your AI agent

> Yes — ClawLink is a hosted Notion MCP server. 45 tools your agent can call from chat, with one-click hosted OAuth and nothing to run locally.

Web version: https://claw-link.dev/hub/notion

ClawLink hosts a managed Notion MCP server that exposes 45 tools to your AI agent. You connect Notion in one click, and your agent can read, create, and update Notion data from chat without you building or running a local MCP server.

## Quick facts

- 45 tools callable from chat
- One-click hosted OAuth
- Works with OpenClaw, Hermes, Claude Code, Cursor, Codex, and any MCP client
- No local server or config files

## Overview

The usual path is: build auth, handle token refresh, wire up the tools. With ClawLink you connect Notion once and start using the real actions from the agent.

## Setup

Notion uses OAuth. You connect it in the browser: click Connect, sign in, approve. ClawLink stores the token and refreshes it on its own. You never touch a key or wire up a redirect URL.

Authentication: hosted OAuth

## What you can do

- **Turn requests into work** — Create Notion docs, tasks, or events straight from the chat where the request landed.
- **Plan, then execute** — The agent checks what's already in Notion, sums it up, then creates the next item. No duplicates.
- **Knock out the small stuff** — Status checks, new entries, detail edits in Notion. The things that usually interrupt you.

## Notion tools

45 Notion tools, ready the moment you connect.

- `notion_create_comment` — Create a comment on a Notion page or discussion
- `notion_create_database` — Create a new Notion database
- `notion_duplicate_page` — Duplicate a Notion page
- `notion_query_database` — Query a Notion database
- `notion_retrieve_page` — Retrieve a Notion page by ID
- `notion_update_block` — Update a Notion block
- `notion_update_page` — Update properties on a Notion page
- `notion_fetch_all_block_contents` — Fetch all child blocks for a given Notion block
- `notion_fetch_block_contents` — Retrieves a paginated list of direct, first-level child block objects along with contents for a
- `notion_fetch_block_metadata` — Fetches metadata for a Notion block (including pages, which are special blocks) using its UUID
- `notion_fetch_comments` — Fetches unresolved comments for a specified Notion block or page ID
- `notion_fetch_data` — Fetches Notion items (pages and/or databases) from the Notion workspace, use this to get
- `notion_fetch_database` — Fetches a Notion database's structural metadata (properties, title, etc.) via its
- `notion_fetch_row` — Retrieves a Notion database row's properties and metadata; use fetch_block_contents for page
- `notion_get_about_user` — Retrieves detailed information about a specific Notion user, such as their name, avatar, and
- `notion_get_page_markdown` — Retrieve a Notion page's full content rendered as Notion-flavored Markdown in a single API call
- `notion_get_page_property_action` — Call this to get a specific property from a Notion page when you have a valid `page_id` and
- `notion_list_data_source_templates` — List all templates for a Notion data source
- `notion_list_file_uploads` — Retrieve file uploads for the current bot integration, sorted by most recent first
- `notion_list_users` — Retrieves a paginated list of users (excluding guests) from the Notion workspace; the number of
- `notion_query_data_source` — Query a Notion data source
- `notion_query_database_with_filter` — Query a Notion database with server-side filtering, sorting, and pagination
- `notion_retrieve_comment` — Retrieve a specific comment by its ID
- `notion_retrieve_database_property` — Retrieve a specific property object of a Notion database
- `notion_retrieve_file_upload` — Retrieve details of a Notion File Upload object by its identifier
- `notion_search_notion_page` — Searches Notion pages and databases by title
- `notion_add_multiple_page_content` — Bulk-add content blocks to Notion
- `notion_append_code_blocks` — Append code and technical blocks (code, quote, equation) to a Notion page
- `notion_append_layout_blocks` — Append layout blocks (divider, TOC, breadcrumb, columns) to a Notion page
- `notion_append_media_blocks` — Append media blocks (image, video, audio, file, pdf, embed, bookmark) to a Notion page

## Example prompts

- **Create comment:** Create it in Notion. Confirm the key fields with me before you finish.
- **Create database:** Create it in Notion. Confirm the key fields with me before you finish.
- **Duplicate page:** Use Notion to duplicate page and walk me through it.
- **Query database:** Use Notion to query database and walk me through it.

## ClawLink vs. building it yourself

| | Manual | ClawLink |
|---|---|---|
| Connection | Build it yourself. You register a developer app with Notion, set up redirect URLs, handle the consent screen, store and refresh access tokens, and redo the wiring when scopes change. | Hosted hosted OAuth. Connect once in the browser. ClawLink owns the lifecycle. |
| Maintenance | Token refresh, permission debugging, env config, every edge case. All yours. | ClawLink handles the plumbing. You focus on the workflow. |
| Time to first call | Days to weeks. Auth, storage, tool wiring, testing. Then the agent can act. | About two minutes from sign-up to the agent calling Notion. |

## FAQ

### How do I connect Notion to my AI agent?

Install ClawLink, open the dashboard, click Connect next to Notion, and finish the hosted OAuth flow. Your agent can call Notion from the next message. Two minutes, total.

### Is there a Notion MCP server I can use?

Yes. ClawLink exposes Notion as 45 tools your agent calls through a hosted MCP-compatible runtime. You don't run a local server or edit a config file. The tools are there the moment you connect.

### Do I need Notion API credentials?

No separate API key. You sign in to Notion through the normal OAuth flow and ClawLink handles the token after that.

### How much does it cost?

Your first integration is free, plus a 7-day trial of the full catalog. Paid plans unlock the rest of the library.

### Can I set this up from the terminal instead of the dashboard?

Yes. Run npx -y @useclawlink/cli login, then npx -y @useclawlink/cli connect notion. The first opens a browser to sign in to ClawLink. The second opens a browser to authorize Notion. No API keys to create. Works with OpenClaw, Hermes, Claude Code, Cursor, Codex, and any agent that runs shell commands.