How to Connect Notion Remote MCP to OpenAI Codex CLI
Add Notion Labs's remote MCP server to OpenAI Codex CLI in about a minute.
Step-by-step
- Edit ~/.codex/config.tomlAdd the
[mcp_servers.notion]table shown in the connect card (TOML) to~/.codex/config.tomlโ Codex loads remote MCP servers at startup. - AuthorizeOn first use your client opens a Notion Labs OAuth consent screen โ approve it and tools become available.
- VerifyRestart Codex, then run
codex mcp list(or ask the agent to call a tool). Verify in the browser: pastehttps://mcp.notion.com/mcpinto remotemcp.net/inspector and run initialize + tools/list.
Troubleshooting OAuth / 401
- A
401 Unauthorizedon first connect is normal โ the endpoint is OAuth-protected; let OpenAI Codex CLI finish the browser consent flow. - If the consent window never opens, remove and re-add the server, then retry.
- Check the exact challenge at our OAuth debugger.
- Run the live endpoint through the online inspector to see the raw JSON-RPC exchange.
Legacy SSE endpoint
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"notion": {
"url": "https://mcp.notion.com/mcp"
}
}
}claude mcp add --transport http notion https://mcp.notion.com/mcp
Or add to .vscode/mcp.json:
{
"servers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
}
}
}- Open Settings โ Connectors (Integrations) โ Add Custom Connector.
- Paste the endpoint URL:
https://mcp.notion.com/mcp - Complete the browser OAuth 2.1 login flow when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.notion.com/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"notion": {
"serverUrl": "https://mcp.notion.com/mcp"
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"notion": {
"url": "https://mcp.notion.com/mcp"
}
}
}Add to ~/.codex/config.toml โ Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.notion] url = "https://mcp.notion.com/mcp"
Add to cline_mcp_settings.json (Cline โ MCP Servers โ Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"notion": {
"type": "streamableHttp",
"url": "https://mcp.notion.com/mcp"
}
}
}Add to ~/.gemini/settings.json under mcpServers โ httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"notion": {
"httpUrl": "https://mcp.notion.com/mcp"
}
}
}Tools exposed by Notion MCP (18)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| notion-search ~34 tok | ๐ข Read | Search pages and databases in the workspace. | โ |
| notion-fetch ~32 tok | ๐ข Read | Fetch a page, database or block content. | โ |
| notion-create-pages ~32 tok | ๐ Write | Create one or more Notion pages. | โ |
| notion-update-page ~32 tok | ๐ Write | Update page properties or content. | โ |
| notion-move-pages ~34 tok | ๐ Write | Move pages between parents or workspaces. | โ |
| notion-duplicate-page ~31 tok | ๐ Write | Duplicate an existing page. | โ |
| notion-create-database ~35 tok | ๐ Write | Create an inline or full-page database. | โ |
| notion-update-database ~35 tok | ๐ Write | Update a database's schema or properties. | โ |
| notion-query-database ~35 tok | ๐ข Read | Query a database with filters and sorts. | โ |
| notion-create-view ~30 tok | ๐ Write | Create a database view. | โ |
| notion-update-view ~33 tok | ๐ Write | Update a database view configuration. | โ |
| notion-create-comment ~34 tok | ๐ Write | Add a comment to a page or discussion. | โ |
| notion-get-comments ~32 tok | ๐ข Read | List comments on a page or block. | โ |
| notion-get-teams ~32 tok | ๐ข Read | List teamspaces in the workspace. | โ |
| notion-get-users ~29 tok | ๐ข Read | List workspace users. | โ |
| notion-get-user ~31 tok | ๐ข Read | Get details of a workspace user. | โ |
| notion-get-self ~33 tok | ๐ข Read | Get the connected bot integration info. | โ |
| notion-get-page-property ~32 tok | ๐ข Read | Get a page property value. | โ |
Connect Notion MCP to another client
Other servers for OpenAI Codex CLI
GitHub's official remote MCP server hosted at api.githubcopilot.com. Gives AI agents first-party access to repositories, issues, pull requests and code search.
Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.
Figma's official remote MCP server. Agents can pull design context, variables, Code Connect mappings and screenshots from your Figma files.
AWS Knowledge's hosted remote MCP server. AWS's fully-managed public knowledge MCP gives agents access to the latest AWS documentation, API references, What's New posts and architectural guidance across all AWS services. It is public and unauthenticated โ connect and call tools immediately.
Stripe's official remote MCP server at mcp.stripe.com. Agents can query customers, payment intents and subscriptions and invoke Stripe API operations with OAuth.
Claude Skills's hosted remote MCP server. ClaudeSkills.club's public MCP lets agents search and pull from a catalog of 90,000+ Agent Skills (SKILL.md) โ workflow specs, safety scores and one-line install instructions. It is public and unauthenticated โ connect and call tools immediately.