Ship a Notion MCP server in 30 minutes

This is a hands-on walkthrough. In 30 minutes, we'll go from an empty directory to a production MCP server that lets Claude Desktop query your Notion workspace, with OAuth in front, rate limits behind, and monetization ready to switch on. Grab a Notion integration token before you start.

Step 1 — Install the CLI

Install Cognoverge globally, or use npx.

$ npm install -g @cognoverge/cli
$ cognoverge login

Step 2 — Scaffold from the Notion template

We ship an official Notion template. Use it as the starting point; the tools it exposes are already the ones most authors want.

$ cognoverge init notion-mcp --from notion
$ cd notion-mcp

Open src/server.ts. The template exposes four tools:search, page.get, page.create, and page.append. Every tool signature includes an input schema and a handler that receives a validated user token.

Step 3 — Wire your Notion integration token

Set it as a secret so it's encrypted at rest and never appears in logs.

$ cognoverge secrets set NOTION_TOKEN

Step 4 — Deploy

$ cognoverge deploy
✓ Bundled 6.1 kB
✓ Provisioned https://notion.<you>.cognoverge.dev
✓ OAuth: Google, GitHub, magic-link
✓ Rate limits, audit log, p95 metrics live
✓ Live in 22.4s

Step 5 — Add it to Claude Desktop

$ cognoverge add notion-mcp --client=claude

Restart Claude Desktop. In a new chat, click the paperclip and pick the notion-mcp server. Claude will trigger OAuth (Google by default) and, once you accept, the tools become available.

Step 6 — Try it

Ask Claude something like "search Notion for 'Q3 roadmap' and summarize what you find." Watch the logs stream in another terminal:

$ cognoverge logs --tail

Step 7 (optional) — Turn on monetization

Two commands and Stripe Connect onboarding.

$ cognoverge monetize enable
$ cognoverge monetize price search 0.001