Agent Interface
MCP Server (official)REST APIWebhooks (beta)
What an agent can do
- ✓Read and search pages, databases, and blocks
- ✓Create and update pages and database entries
- ✓Query database views with filters and sorts
- ✓Append blocks to existing pages
- ✓Search workspace by keyword
- ✓Retrieve user and workspace metadata
What it can't do
- ✗Access comments programmatically (read-only, no create via MCP)
- ✗Modify workspace settings or permissions
- ✗Export pages to PDF or Markdown via API
- ✗Real-time collaborative editing via API
- ✗Access Notion AI features programmatically
Auth Model
OAuth 2.0 (user-level)Internal Integration Token (workspace-level)
Builder Notes
Notion's official MCP server launched 2025. Covers all major CRUD operations. OAuth is preferred for user-delegated access; internal tokens for workspace automation. Rate limits: 3 req/sec per integration.
Sources
Last verified: 2026-03-01