Notion
ConnectionSearch and edit Notion pages and databases over MCP or OpenAPI.
Install
Connections live under agent/connections/. Auth is brokered by Vercel Connect, so install the framework and the Connect SDK:
npm install eve@latest @vercel/connectQuick start
Create agent/connections/notion.ts. The connection name is derived from the filename:
// 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:
vercel connect create notionvercel linkvercel env pullFor 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.
Agents using Notion
PR Review Sentinel
Review pull requests against team conventions, flag risky changes, and post structured, actionable feedback.
API Contract Guardian
Detect drift between API specs, real behavior, and docs; draft changelogs, migration notes, and fixes.
Competitive Intel Scout
Track competitors' pricing, changelogs, and traffic; report evidence-cited changes since the last check.
AI Search Visibility Analyst
Measure how your brand appears in AI answers and search, diagnose citation gaps, and prioritize content fixes.
Chief of Staff (WhatsApp)
A pocket chief of staff: captures tasks from quick messages, tracks commitments, and remembers what matters across weeks.
Developer Community Manager
Triage community questions, escalate real bugs with reproductions, and turn recurring pain into roadmap signal.