Connect Notion to Codex
Connected workspace for docs and databases. Its hosted MCP server lets agents search, read and edit pages and databases, such as briefs, specs and research notes.
MCP serverOfficialChecked 2026-11-16
Before you start
- Codex installed (see its MCP documentation (opens in a new tab)).
- Notion is available on macOS, Windows, Linux and the web.
- Works on every Notion plan; guests can't connect. Your agent opens a Notion sign-in page the first time it connects. Notion's older open-source server is no longer maintained, so use this hosted one.
Step 1: Add Notion to Codex
Add it from the terminal
Saves the server to
~/.codex/config.toml, so it works in every project.Terminal codex mcp add notion --url https://mcp.notion.com/mcpOr edit the config file
Add this to
~/.codex/config.toml.~/.codex/config.toml [mcp_servers.notion] url = "https://mcp.notion.com/mcp"Good to know- Sign in once with
codex mcp login notion.
- Sign in once with
Step 2: Check it's connected
Terminal codex mcp listIn a Codex session, run
/mcpto see connected servers and their tools.Step 3: Try a first request
Ask Codex something that only works with Notion connected:
Say to Codex Find the Notion page with our latest product brief and summarise the goals and open questions.
If it doesn't work
- Codex reads
~/.codex/config.toml. A project.codex/config.tomlis only read in projects you have trusted. - Codex doesn't expand
~or environment variables incommand. Use a full path in the config file. - Servers that need a sign-in: run
codex mcp login <name>.





