How to Install Notion MCP Server in OpenAI Agents SDK
Read, write, and search your Notion workspace — databases, pages, and knowledge base
What Notion MCP Server does
Connect your AI agent to Notion for full workspace access. Create and update pages, query databases, search across your knowledge base, and manage your team's documentation through natural language. Features: - Create, read, update, and delete Notion pages - Query and filter Notion databases - Workspace-wide full-text search - Add blocks to pages (text, lists, code, tables, callouts) - Manage database properties and schema - Handle nested pages and block hierarchies - Read and create comments - Access shared pages and team spaces This is one of the most popular productivity MCP servers — with 2,500+ GitHub stars — because Notion is where most teams store their knowledge, and having AI natively access it transforms how teams work. Requirements: - Notion Integration Token (create at notion.so/my-integrations) - The integration must be added to the pages/databases you want to access
Installation steps
- 1Install: pip install openai-agents
- 2Copy the snippet below into your agent code
- 3Replace placeholder env values with your real keys
- 4Pass mcp_servers=[mcp_server] to your Agent()
Python snippet
from agents import Agent
from agents.mcp import MCPServerStdio
mcp_server = MCPServerStdio(
command="npx",
args=["-y", "@notionhq/notion-mcp-server"],
env={
"NOTION_API_TOKEN": "secret_...",
},
)
agent = Agent(
name="My Agent",
model="gpt-4o",
mcp_servers=[mcp_server],
)Install in other clients
For maintainers
If you maintain Notion MCP Server, add this badge to your README to show it's verified on CuratedMCP:
[](https://curatedmcp.com/marketplace/notion-mcp-server)