Skip to main content
Glama
hinha

notion-bank-mcp

by hinha
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
XDG_CONFIG_HOMENoXDG base directory for config (default ~/.config)
NOTION_BANK_CONFIG_PATHNoOverride path for config file (default ~/.config/notion-bank/config.json)
NOTION_BANK_CREDENTIALS_PATHNoOverride path for credentials file (default ~/.config/notion-bank/credentials.json)

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
plan_statusA

Show auth + workspace status. Call first. End users need no CLIENT_ID — browser OAuth opens automatically.

plan_oauth_loginA

Open browser for Notion login (mcp.notion.com). Auto-runs on first Notion tool if not logged in. No CLIENT_ID/SECRET.

plan_oauth_waitB

Finish a pending plan_oauth_login(wait=false) after the user approves in the browser.

plan_oauth_logoutA

Clear saved OAuth credentials for this user (credentials.json). Does not revoke at Notion end.

plan_configureA

Persist per-user workspace settings (NOT in repo .env). Pass the user's Plans root Notion URL or UUID. Optional services map slug→page_id. Merges services by default. Call after plan_status when root_page_id missing. Ask the user for their root page — never invent IDs.

plan_ensure_serviceA

Ensure a service page exists under the configured Plans root. Creates if missing. Requires plan_configure + NOTION_TOKEN.

plan_migrateB

Migrate a local markdown file into Notion plan bank (upsert under service → title). Requires plan_configure + NOTION_TOKEN. Chunking handled inside MCP.

plan_upsertB

Create or update a plan from a markdown string. Upserts by exact title under the service page. Requires plan_configure + NOTION_TOKEN.

plan_getA

Fetch a plan as addressable markdown with L00N| line numbers, TOC, and etag. Always call before plan_update_range. Requires plan_configure + NOTION_TOKEN.

plan_searchB

Search configured plan bank. Hits include service, title, url, line, snippet (lines match plan_get). Requires plan_configure + NOTION_TOKEN.

plan_update_rangeB

Surgical update by section (preferred) or start_line/end_line. Pass expected_etag from plan_get. Errors if neither section nor lines given (no silent full replace). Requires plan_configure + NOTION_TOKEN.

plan_syncB

Export a Notion plan (canonical) to a local markdown file. Requires plan_configure + NOTION_TOKEN.

Prompts

Interactive templates invoked by user choice

NameDescription
save-planGuided flow: ensure configured, then upsert a plan under a service
revise-sectionGuided flow: plan_get then plan_update_range with etag

Resources

Contextual data attached and managed by the client

NameDescription
workflowHow agents should set up and use notion-bank tools across Cursor/Claude/Codex/OpenCode
instructionsSame text sent on MCP initialize
configPer-user workspace config + status (no secrets). Path from plan_status.

Latest Blog Posts

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