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)

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

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