Connect Notion (MCP token) to Zed
Notion's hosted MCP server, reached with a token instead of a browser sign-in, so agents can connect with nobody there to approve it. Needs a Business or Enterprise plan.
MCP serverOfficialChecked 2026-11-16
Before you start
- Zed installed (see its MCP documentation (opens in a new tab)).
- Notion (MCP token) is available on macOS, Windows, Linux and the web.
- Only workspace owners on Business and Enterprise plans can create a token, with New MCP token in Notion's Developer portal. Set it as
NOTION_MCP_TOKENin your environment. On other plans, use the Notion entry, which signs in through your browser.
Step 1: Add Notion (MCP token) to Zed
Add it to your settings
Run zed: open settings file from the command palette and add this inside the top-level object, next to your other settings.
~/.config/zed/settings.json { "context_servers": { "notion-token": { "url": "https://mcp.notion.com/mcp", "headers": { "Authorization": "Bearer YOUR_NOTION_MCP_TOKEN" } } } }Good to know- Zed keeps header values in your settings file, which stays on your machine. Replace
YOUR_NOTION_MCP_TOKENwith the token.
- Zed keeps header values in your settings file, which stays on your machine. Replace
Step 2: Check it's connected
Open Settings → AI → MCP Servers. A green dot next to the server means it is running.
Step 3: Try a first request
Ask Zed something that only works with Notion (MCP token) connected:
Say to Zed Find the Notion database that tracks our design tasks and list what's due this week.
If it doesn't work
- Zed reads MCP servers from the
context_serverskey, notmcpServers. Servers under any other key are ignored. - Run zed: open settings file from the command palette to edit your settings.
- Zed asks before running each tool. Change this with
agent.tool_permissionsin your settings.





