Notion integration for AI agents.
Let your AI agents work in Notion — create and update pages, query and edit databases, and search the workspace — through a routed, audited connection. Open Connector runs the OAuth, seals the token in an encrypted vault, and serves Notion tools to your agent over MCP or a typed API — credentials injected server-side, every call audited, nothing leaving your infrastructure. Open source (AGPL-3.0) and self-hostable.
Real Notion actions, managed and audited.
Your user connects Notion once; your agent can then create and update pages, query and edit databases, and search the workspace — scoped to the OAuth permissions you grant and the tool allowlist you configure. Every action is least-privilege and written to a tamper-evident audit trail.
- 1
Your user grants Notion access once (OAuth) — the token lands in the vault.
- 2
Your agent calls a tool over MCP or the typed API; Open Connector injects the credential server-side.
- 3
Every routed call appends a hash-chained audit record — nothing leaves your infra.
Supported Notion tools.
48 tools are generated from the published Notion catalog. Descriptions are plain text; each action remains subject to its configured authentication and tool allowlist.
Showing 48 tools. All published catalog entries are included in this page's server-rendered HTML.
- Complete a multi-part file upload
- Complete a multi-part file upload
- File uploads
- Create a comment
- Create a comment
- Comments
- Create a data source
- Create a data source
- Data sources
- Exchange an authorization code for an access and refresh token
- Exchange an authorization code for an access and refresh token
- OAuth
- Create a database
- Create a database
- Databases
- Create a file upload
- Create a file upload
- File uploads
- Create a view
- Create a view
- Views
- Create a view query
- Create a view query
- Views
- Delete a block
- Delete a block
- Blocks
- Delete a comment
- Delete a comment
- Comments
- Delete a view
- Delete a view
- Views
- Delete a view query
- Delete a view query
- Views
- Retrieve block children
- Retrieve block children
- Blocks
- Retrieve your token's bot user
- Retrieve your token's bot user
- Users
- Retrieve a user
- Retrieve a user
- Users
- List all users
- List all users
- Users
- Get view query results
- Get view query results
- Views
- Introspect a token
- Introspect a token
- OAuth
- List comments
- List comments
- Comments
- List custom emojis
- List custom emojis
- Custom emojis
- List templates in a data source
- List templates in a data source
- Data sources
- List file uploads
- List file uploads
- File uploads
- List views
- List views
- Views
- Move a page
- Move a page
- Pages
- Append block children
- Append block children
- Blocks
- Update page
- Update page
- Pages
- Query a data source
- Query a data source
- Data sources
- Create a page
- Create a page
- Pages
- Search by title
- Search by title
- Search
- Query meeting notes
- Query meeting notes
- Meeting notes
- Retrieve a block
- Retrieve a block
- Blocks
- Retrieve a data source
- Retrieve a data source
- Data sources
- Retrieve a page
- Retrieve a page
- Pages
- Retrieve a page property item
- Retrieve a page property item
- Pages
- Retrieve a view
- Retrieve a view
- Views
- Retrieve an async task
- Retrieve an async task
- Async tasks
- Retrieve a comment
- Retrieve a comment
- Comments
- Retrieve a database
- Retrieve a database
- Databases
- Retrieve a file upload
- Retrieve a file upload
- File uploads
- Retrieve a page as markdown
- Retrieve a page as markdown
- Pages
- Revoke a token
- Revoke a token
- OAuth
- Update a block
- Update a block
- Blocks
- Update a comment
- Update a comment
- Comments
- Update a data source
- Update a data source
- Data sources
- Update a view
- Update a view
- Views
- Update a database
- Update a database
- Databases
- Update a page's content as markdown
- Update a page's content as markdown
- Pages
- Upload a file
- Upload a file
- File uploads
Notion integration, answered
- How do AI agents use Notion through Open Connector?
- Your user connects Notion once (OAuth). Open Connector stores the token in an encrypted vault and exposes Notion tools to your agent over MCP or a typed API, injecting the credential server-side on each call — the agent never sees a raw token, and every action is audited.
- Is this a Notion MCP server?
- Yes. Open Connector can serve Notion as a named MCP server with a scoped tool allowlist and a per-user mcp_url, so any MCP client connects and calls Notion tools with credentials routed server-side.
- Where do Notion OAuth tokens live?
- In your own infrastructure. Self-host Open Connector and the Notion token is sealed in an AES-256-GCM vault in your Postgres, injected at call time — it never leaves your environment.
Give your agents Notion — keep the keys.
Open source, self-hostable, with Notion credentials that never leave your infrastructure. Run it from source today.