All integrations

Notion

ConnectionMCPOpenAPI

Search and edit Notion pages and databases over MCP or OpenAPI.

Read the full connection docs

Install

Connections live under agent/connections/. Auth is brokered by , so install the framework and the Connect SDK:

bash
npm install eve@latest @vercel/connect

Quick start

Create agent/connections/notion.ts. The connection name is derived from the filename:

ts
// agent/connections/notion.tsimport { connect } from "@vercel/connect/eve";import { defineMcpClientConnection } from "eve/connections";
export default defineMcpClientConnection({  url: "https://mcp.notion.com/mcp",  description: "Notion workspace: search and edit pages and databases.",  auth: connect("notion"),});

Connect owns the OAuth flow, and each end-user authorizes in their own browser before their first tool call.

Configure

Create the connector, link it to your project, and pull OIDC locally:

bash
vercel connect create notionvercel linkvercel env pull

For JWT bearer, principalToSubject controls the asserted subject. The default maps app principals to { type: "app" } and user principals to { type: "user", id, issuer }.

The OpenAPI setup sends the required Notion-Version header; bump it as Notion ships new API versions.

See the for principal types, headers, approval, and tool filters.