What can you do with this server?

The notion-bank-mcp server allows AI agents (Cursor, Claude, Codex, etc.) to create, read, update, search, and sync Markdown implementation plans stored in Notion. It supports a structured hierarchy (Plans root → service page → plan page) and uses browser-based OAuth so no secrets are needed in config. Key capabilities: * Authentication & Status: Check auth and workspace readiness (plan_status); manage OAuth lifecycle (plan_oauth_login, plan_oauth_wait, plan_oauth_logout). * Workspace Configuration: Set Plans root URL and service mappings (plan_configure); ensure service pages exist (plan_ensure_service). * Plan Management: Create/update plans from markdown strings (plan_upsert) or local files (plan_migrate); retrieve plans with line numbers, TOC, and etag (plan_get); perform surgical line/section edits with concurrency control (plan_update_range); search across plans with line-level hits (plan_search); export plans to local markdown (plan_sync); create subpages (plan_create_child). * Integration: Works with MCP hosts via stdio or HTTP, storing user config locally at ~/.config/notion-bank/.

Which integrations are available for this server?

Manages implementation plans in Notion with a structured hierarchy (Plans root → service page → plan page), providing tools for creating, reading, updating (including section-level edits with optimistic concurrency via etags), searching, and syncing plans as markdown.

How do I use notion-bank-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@notion-bank-mcp Get the current status of my plan bank" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

notion-bank-mcp

by hinha

Overview Schema Related Servers Score Discussions

TypeScript

Hybrid

notion-bank-mcp

Plan-bank MCP for AI agents — read and write Markdown implementation plans in Notion with line + section addressing, for Cursor, Claude, Codex, and other MCP hosts.

Auth: browser OAuth via mcp.notion.com. No CLIENT_ID / SECRET for end users. No integration token in mcp.json.

npx -y notion-bank-mcp@latest --version

Why use notion-bank-mcp?

Generic Notion MCPs are great for browsing a workspace. notion-bank-mcp is optimized for one job: keep implementation plans in Notion in a shape agents can reliably create, revise, and ship — without throwaway scripts.

Advantage	What you get
Plan-bank domain	First-class hierarchy: Plans root → service page → plan page. Agents follow one flow instead of inventing page structure every time.
Surgical edits	`plan_update_range` edits by section or line range, with `expected_etag` so concurrent overwrites fail safely.
Markdown in / Markdown out	Upsert from file or string; `plan_get` returns numbered lines + TOC so the model can point at exact slices.
No temp glue	Stop generating one-off Python/shell to patch Notion. The MCP is the stable API for plan migrate/sync.
Zero secrets for end users	Install with `npx` only. Browser OAuth via `mcp.notion.com` — no `CLIENT_ID`, no integration token in `mcp.json`.
Per-user workspace mapping	Each machine stores Plans root + service map under `~/.config/notion-bank/` — no shared workspace IDs in the repo.
Agent-ready first steps	`plan_status` → OAuth if needed → ask for Plans root once → ready. Predictable for Cursor / Claude / other MCP hosts.
Search with line hits	`plan_search` surfaces matches in context of the plan body, not only page titles.
Optional export	`plan_sync` pulls Notion → local markdown when you want a file in git or a PR.

When to prefer this over the official Notion MCP alone: you maintain a plan bank across services, you need section-level revisions with concurrency checks, and you want agents to do that in one tool surface instead of free-form page updates.

Related MCP server: tentra

Quick start

Add this to your MCP config (Cursor example — same shape works for Claude Desktop / Codex):

{
  "mcpServers": {
    "notion-bank": {
      "command": "npx",
      "args": ["-y", "notion-bank-mcp@latest"]
    }
  }
}

Restart the host. Tools like plan_status and plan_upsert should appear.
On the first Notion action, a browser opens → sign in with Notion.
Tell the agent your Plans root Notion page URL once → it runs plan_configure.

That is enough for most users.

Install options

Method	When to use
`npx -y notion-bank-mcp@latest`	Recommended — always latest, no global install
`npm i -g notion-bank-mcp` then `notion-bank-mcp`	Frequent local use
Clone + `make build`	Developing the server itself

Check / update the CLI:

notion-bank-mcp --version          # or: notion-bank-mcp version
notion-bank-mcp update             # checks npm only — does not auto-install
notion-bank-mcp --help

If update reports a newer version:

npm i -g notion-bank-mcp@latest
# or keep using npx -y notion-bank-mcp@latest

CLI

Command	Purpose
`(default)` / `--stdio`	MCP over stdio (hosts)
`serve` / `--http`	Streamable HTTP (optional hosted URL)
`version` / `--version` / `-V`	Print package version
`update`	Compare local version to npm `latest`
`help` / `--help` / `-h`	Short usage

Env (optional)

Env	Description
`NOTION_BANK_CONFIG_PATH`	Override path to `config.json`
`NOTION_BANK_CREDENTIALS_PATH`	Override path to OAuth credentials
`NOTION_BANK_CACHE_TTL_MS`	In-process cache TTL (default `60000`)
`NOTION_BANK_CACHE_MAX_ENTRIES`	Cache LRU cap (default `256`)
`NOTION_BANK_MODE`	Set `http` to force HTTP serve
`NOTION_BANK_LOCAL_CALLBACK_PORT`	OAuth callback port (default `8765`)

HTTP-only (operators): NOTION_BANK_PUBLIC_URL, NOTION_BANK_HOST, NOTION_BANK_PORT, NOTION_BANK_HTTP_IDLE_MS. See docs/OPERATOR.md.

Local from source

make install && make check && make build
make stdio
# or: node dist/index.js

From a local clone before publishing:

{
  "mcpServers": {
    "notion-bank": {
      "command": "node",
      "args": ["/absolute/path/to/notion-bank-mcp/dist/index.js"]
    }
  }
}

Host compatibility

Primary transport is stdio. Same command + args pattern as other MCP servers. No env tokens required.

Host	Config	Notes
Cursor	`.cursor/mcp.json` or Settings → MCP	See `mcp.json.example`
Claude Desktop	`claude_desktop_config.json`	Same `mcpServers` JSON
Claude Code	MCP settings	Stdio; optional skill under `.claude/skills/`
Codex	MCP / tools config	Same pattern
Windsurf / OpenCode	MCP `command`/`args`	Prefer stdio

Agent flow

npx notion-bank-mcp@latest  (host starts stdio)
        │
        ▼
plan_status
        │
        ├─ no auth → browser OAuth (localhost callback :8765)
        │            tokens → ~/.config/notion-bank/credentials.json
        │
        └─ no root → ask Plans root URL → plan_configure
                     config → ~/.config/notion-bank/config.json
        │
        ▼
plan_upsert / plan_get / plan_update_range / …

Hierarchy:

Plans / Superpowers          ← root (plan_configure)
  └── <Service>              ← plan_ensure_service
        └── <Plan title>     ← plan_upsert / plan_migrate

Tools

Tool	Purpose
`plan_status`	Auth + workspace readiness
`plan_oauth_login` / `plan_oauth_wait` / `plan_oauth_logout`	Browser OAuth lifecycle
`plan_configure`	Persist Plans root (+ optional service map)
`plan_ensure_service`	Ensure service page under root
`plan_create_child`	Create a subpage under any parent page id/URL
`plan_upsert` / `plan_migrate`	Create/update plan from markdown or file
`plan_get`	Read with optional `L00N\|` lines, TOC, etag
`plan_update_range`	Surgical edit by section / lines + `expected_etag`
`plan_search`	Search with line hits
`plan_sync`	Export Notion plan → local markdown

Resources

notion-bank://docs/workflow
notion-bank://docs/instructions
notion-bank://config

Config (per user / machine)

Stored outside the git repo:

Path	Contents
`~/.config/notion-bank/config.json`	Plans root + service map
`~/.config/notion-bank/credentials.json`	OAuth access / refresh tokens
`~/.config/notion-bank/oauth-pending.json`	Short-lived login state (auto-cleared)

Do not put Notion tokens or OAuth client secrets in the repo or in committed mcp.json. Access tokens expire (~8h); the server refreshes automatically when possible. If refresh fails, run plan_oauth_login again.

HTTP serve

Optional hosted URL mode for teams that want "url": "https://host/mcp" instead of stdio:

npm run serve
# or: notion-bank-mcp serve

Details: docs/OPERATOR.md. Not required for normal users.

Skills

MCP tools and skills are separate. The skill teaches the agent when/how to document in Notion; the server only registers tools.

Shipped skill: skills/notion-bank/SKILL.md
Slash name: /notion-bank

Copy into your host skills directory (with notion-bank MCP enabled):

Host	Typical path
Cursor	`.cursor/skills/notion-bank/` or user skills
Claude Code	`.claude/skills/notion-bank/`
Codex / agents	`.agents/skills/notion-bank/`

The skill chains superpowers (brainstorming → writing-plans) and optimize-goal when applicable, uses an in-skill engineering checklist, and always returns the Notion URL.

Developers

make check          # typecheck + biome + tests (coverage fail <75%, warn <90%)
make test-coverage
make release VERSION=1.5.0   # bump package.json, commit, create annotated tag v1.5.0
git push && git push origin v1.5.0   # triggers GitHub Actions → npm publish

Coverage policy: CI fails below 75% (lines/statements/functions/branches). Below 90% emits a warning annotation only.

Release: git tag vX.Y.Z is the source of truth. The release workflow syncs package.json version from the tag, runs checks, then npm publish. Requires repo secret NPM_TOKEN.

Docs

License

MIT

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Tools

View all tools

Related MCP Servers

Better Notion MCP
Workplace & Productivity Content Management Systems Note Taking
n24q02m
A
license
A
quality
A
maintenance
Markdown-first MCP server for Notion that provides 7 composite action-based tools consolidating 28+ REST API endpoints, enabling AI agents to efficiently manage pages, databases, blocks, and content with automatic pagination and bulk operations.
Updated 3 days ago (2026-08-07 23:04 UTC)
11
151
36
Apache 2.0
tentra
Knowledge & Memory Code Analysis Software Architecture
rdanieli
A
license
B
quality
D
maintenance
Memory for AI coding agents. Persistent code graph + AI architecture diagrams. 32 MCP tools
Updated 2 months ago (2026-06-11 18:48 UTC)
32
41
5
MIT
RoadBoard
Project Management Knowledge & Memory Autonomous Agents
Maless88
A
license
-
quality
B
maintenance
Multi-project execution, memory, and collaboration platform for humans and AI agents, providing MCP tools for agents to read and write project state.
Updated 12 days ago (2026-07-29 06:45 UTC)
2
MIT
Universal Coder Bridge
sorensadrgit-art
A
license
-
quality
C
maintenance
An MCP+HTTP control plane for routing work to multiple coding-agent CLIs through a normalized contract, enabling multi-agent coding pipelines with planning, implementation, review, and revision.
Updated 16 days ago (2026-07-25 08:07 UTC)
MIT

View all related MCP servers

Related MCP Connectors

XMemo
User-owned memory for AI agents, Copilot, Claude, IDEs, CLIs, and chat apps over remote MCP.
nlqdb — analytical memory for AI agents
Analytical memory for AI agents: a real Postgres queried in plain English over MCP. One command.
PlanWright
Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hinha/notion-bank-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

notion-bank-mcp

Why use notion-bank-mcp?

Quick start

Install options

CLI

Env (optional)

Local from source

Host compatibility

Agent flow

Tools

Resources

Config (per user / machine)

HTTP serve

Skills

Developers

Docs

License

Maintenance

Resources

Tools

Related MCP Servers

Better Notion MCP

tentra

RoadBoard

Universal Coder Bridge

Related MCP Connectors

Latest Blog Posts

MCP directory API