Introducing: the Notion Developer Platform
New building blocks that help you (and your coding agents) sync any data source, build any tool, and orchestrate any agent.
Follow along 👇
We’ve open-sourced our MCP (Model Context Protocol) — now available on GitHub.
Plug it into your favorite client and start building richer AI integrations with Notion in minutes ✨
🏗️ The wait is over! Notion's API is now in public beta.
→ Retrieve, query & list databases
→ Create & retrieve pages, and update properties
→ Search pages & databases
→ Retrieve & append block children
Get started at developers.notion.com.
Agents are getting more powerful.
But without a way to use your tools, they can’t actually get much done.
That’s why we’ve launched Notion’s hosted MCP server — so AI agents like @cursor_ai + @claudeai can work directly in your workspace. Here’s the inside story…
We're on track for the public beta this Spring 🌿
Curious about how it's coming along?
🆕 Integrations can read and write page content
🆕 Access to pages outside of databases
Next up:
🔜 OAuth for access to multiple workspaces
🔜 Users can share pages during authorization
Quick progress report!
Functionality enabled by the API so far:
✔️ Query, filter & sort content in DBs
✔️ Workflow automation
✔️ Sync DBs with other tools
What we're building right now:
🔜 Webhooks
🔜 Unblock OAuth use case
Sign up here for more:
Just shipped: file uploads via API.
Images, videos, PDFs, whatever you need, now supported. A few things you can do:
- Auto-assign emojis + cover images
- Migrate files from Google Drive, etc.
- Upload contracts or log feedback w/ screenshots
New: Notion MCP — a hosted server for AI agents to securely read + write in your workspace.
Works out of the box with @ChatGPTapp, @claudeai, and @cursor_ai. So your AI tools can reference, create, and update — like real teammates.
We just launched our new comments API! This allows you to:
→ Read comments from a page or block
→ Add a comment to a page
→ Add a comment to an existing thread
💬 Learn more: ntn.so/commentsAPI
🌱 We are still on track to launch the public beta this spring!
Here's what we've been up to lately:
✔️ Improved error handling
✔️ Including created_time and last_updated_time in page responses
🔜 Third party auth
🔜 Read & write page contents (anything beneath DB properties)
🚨 New API endpoints! Now you can:
→ Create a database and update its properties
→ Update a block's content without having to delete and create a new one
→ Retrieve a block
There's also a new version with non-backwards-compatible changes — learn more: developers.notion.com/changelog/noti…
💥 Last week, we brought Notion’s API out of beta, accompanied by:
→ Support for additional block types
→ Better admin controls and permissions
→ A brand new integration gallery
Start building now!
🥁 Just shipped some top feature requests for the API!
→ Update and retrieve page icons & cover images
→ Add and retrieve externally hosted images & files
→ List and append NEW block types: embed, image, video, file, PDF & bookmarks
Learn more: developers.notion.com/changelog/page…