Which integrations are available for this server?

Provides tools for interacting with Notion's API, enabling AI agents to manage pages, databases, and blocks in Notion workspaces, with support for health monitoring, automatic reconnection, and fallback to direct REST API.

How do I use notion-mcp-wrapper?

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-mcp-wrapper move page abc123 to parent xyz789" 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-mcp-wrapper

by Charpup

Overview Schema Related Servers Score Discussions

JavaScript

Remote

OpenClaw Notion MCP Wrapper

Version OpenClaw Skill Node.js License: MIT evals Oathe Security

Production-ready Notion MCP Server wrapper with health monitoring, automatic reconnection, and transparent fallback to direct REST API. Built for OpenClaw agents operating in headless / cloud environments.

Companion skill: openclaw-notion-md-converter — Markdown → Notion blocks conversion.

AI Agent Quick Reference

# Skill identity (SKILL.md frontmatter)
name: notion-mcp-wrapper
version: "2.0.1"
triggers:
  - "notion"
  - "mcp"
  - "notion-mcp-wrapper"
  - "move page"
  - "notion health"

# Runtime requirements
requires:
  bins: [node, npm]
  env: [NOTION_TOKEN]   # or NOTION_API_KEY

# Install
run: cd ~/.openclaw/skills/notion-mcp-wrapper && npm install

When to invoke:

Check Notion MCP connectivity / health status
Execute Notion operations (movePage, createPage, updatePage, deletePage) via MCP
Auto-reconnect after MCP server crash or timeout
Fall back to direct Notion REST API when MCP is unavailable

When NOT to invoke:

Simple Notion reads that work directly via MCP tools
Non-Notion operations

Related MCP server: notion-full-mcp

Features

Feature	Description
Health Monitoring	Continuous MCP ping; reports `healthy` / `degraded` / `down` with latency
Auto Reconnect	Exponential backoff retry — configurable `maxRetries` and `baseDelayMs`
Seamless Fallback	Auto-switches to Notion REST API when MCP fails; transparent to callers
Operation Support	movePage, getPage, updatePage, createPage, deletePage (with fallback)
Full Test Suite	Unit + integration tests via Jest

Installation

git clone https://github.com/Charpup/openclaw-notion-mcp-wrapper.git \
  ~/.openclaw/skills/notion-mcp-wrapper
cd ~/.openclaw/skills/notion-mcp-wrapper
npm install

Environment:

export NOTION_TOKEN="ntn_YOUR_INTERNAL_INTEGRATION_TOKEN"
# Alternative:
export NOTION_API_KEY="ntn_YOUR_INTERNAL_INTEGRATION_TOKEN"

Headless / cloud setup: Use an Internal Integration Token — no browser OAuth needed. Share target Notion pages with your integration before use.

Usage

As a Library

const { NotionMCPWrapper } = require('./lib/notion-mcp-wrapper');

const wrapper = new NotionMCPWrapper({
  maxRetries: 5,
  baseDelayMs: 1000,
  enableHealthMonitor: true,
  enableFallback: true,
});

await wrapper.start();

// Execute with automatic MCP → API fallback
const result = await wrapper.execute('movePage', {
  page_id: 'abc123def456',
  parent: { page_id: 'xyz789ghi012' },
});

console.log(result.source); // 'mcp' | 'fallback'
await wrapper.stop();

CLI

npm run health                                             # Check MCP health
node bin/notion-mcp-wrapper.js move-page <page-id> <parent-id>
npm test                                                   # Run test suite

Supported Operations

Operation	MCP Tool	API Fallback
`movePage`	`API-move-page`	✅
`getPage`	`API-retrieve-a-page`	✅
`updatePage`	`API-patch-page`	✅
`createPage`	`API-post-page`	✅
`deletePage`	`API-delete-a-block`	✅
`getBlockChildren`	`API-get-block-children`	❌
`appendBlocks`	`API-patch-block-children`	❌
`queryDatabase`	`API-query-data-source`	❌
`search`	`API-post-search`	❌

Architecture

NotionMCPWrapper  ←  entry point
├── HealthMonitor     periodic MCP ping → healthy / degraded / down
├── RetryPolicy       exponential backoff, configurable maxRetries
├── MCPClient         stdio-based MCP protocol communication
└── FallbackStrategy  Notion REST API when MCP unavailable

Evals

Skill test cases live in evals/evals.json following the skill-creator standard:

ID	Scenario	Expected Trigger
1	Check Notion MCP health status	✅ Yes
2	Move page via MCP wrapper with fallback	✅ Yes
3	Write a JavaScript string-reversal function	❌ No

Version History

Version	Changes
v2.0.1	Add `metadata.openclaw` compliance block; add `evals/evals.json` (3 cases)
v2.0.0	Production rewrite: HealthMonitor, RetryPolicy, FallbackStrategy, full tests

openclaw-notion-md-converter — Markdown → Notion blocks
triadev — Golden Triangle workflow (uses this skill)
OpenClaw — The agent framework

License

MIT — Charpup

Changelog

2026-03-11: Skill audit upgrade — normalized SKILL.md frontmatter to name + description, revalidated trigger wording, and rechecked lightweight lint/smoke compatibility with OpenClaw.

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

1wRelease cycle

4Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

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.
Last updated 2026-07-30
11
738
35
MIT
notion-full-mcp
Note Taking Workplace & Productivity
cphoskins
A
license
A
quality
C
maintenance
Full-featured Notion MCP server enabling deep page reading, block editing, snapshot/restore, file uploads, table manipulation, page restore, and destructive page copying.
Last updated 2026-04-09
33
MIT
notion-private-api-mcp
Note Taking Knowledge & Memory
kirvigen
A
license
A
quality
A
maintenance
Unofficial Notion MCP server built on Notion's private API (token_v2 cookie). Gives LLM agents full read/write access to the entire workspace — no integration token and no per-page sharing.
Last updated 2026-06-01
11
27
4
MIT
notion-enhanced
Note Taking Knowledge & Memory
davidlinjiahao
F
license
-
quality
D
maintenance
Enhanced Notion MCP server supporting all 24 property types, auto-pagination, block operations, and markdown conversion for database and page operations.
Last updated 2026-02-04
1

View all related MCP servers

Related MCP Connectors

remnus
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
better-notion-mcp
Markdown-first MCP server for Notion API with 8 composite tools and 39 actions.
Supabase
MCP server for interacting with the Supabase platform

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/Charpup/openclaw-notion-mcp-wrapper'

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