All integrations

Notion

ConnectionMCPOpenAPI

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

Read the full connection docs

Install

Add the connection from eve's registry. This writes the initial definition under agent/connections/ and installs its authentication dependency when needed:

bash
eve add connection/notion

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

Link your project, create the connector, and pull OIDC locally:

bash
vercel linkvercel connect create notionvercel 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 Connections docs for principal types, headers, approval, and protocol-specific filters.