notion

Compile Notion tools into a typed asynchronous Python SDK.

7|2|Updated Mar 3, 2026

Search Tags:#automation #oauth #python #sdk #mcp #notion #tools

Ready to run

npx skills add https://github.com/manojbajaj95/mcp-skill --skill notion-manojbajaj95

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/manojbajaj95/mcp-skill/tree/main/skills/notion
Command: npx skills add https://github.com/manojbajaj95/mcp-skill --skill notion-manojbajaj95

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts MCP-exposed Notion tools into a typed, asynchronous Python SDK to eliminate repetitive model round-trips and enable programmatic tool calling from agent code.

Core Features & Use Cases

Typed async SDK: Each MCP tool becomes a typed async method for direct invocation in Python.
Comprehensive Notion operations: Search, fetch, create/update pages, move/duplicate pages, create/update databases, comments and user/team lookups.
Auth & data handling: Handles OAuth token persistence, preserves enhanced Notion Markdown, and attempts JSON parsing of tool outputs for easy consumption.
Use Case: Automate a multi-step workflow that searches for documents, fetches full content, updates pages or databases, and applies templates without extra model loop round-trips.

Quick Start

Use the notion skill to search for pages about "Q1 roadmap" and fetch the top result's full content for processing.

Frequently Asked Questions about notion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I call Notion tools directly in Python without extra model round-trips?▼

You can call Notion tools directly in Python by using a typed asynchronous SDK that compiles MCP Notion tools into programmatic methods, eliminating repetitive model round-trips and enabling direct invocation from agent code.

What Notion database operations can I automate using a Python SDK?▼

You can automate comprehensive Notion database operations including creating databases with SQL DDL, updating records, searching pages, fetching content, moving items, and duplicating pages within your automated Python workflows.

Can I create Notion databases using SQL DDL in an automated Python workflow?▼

Yes, you can create Notion databases using SQL DDL. The typed Python SDK accepts SQL DDL for database creation, allowing you to programmatically define and instantiate Notion databases within your automation scripts.

Does the SDK preserve enhanced Notion Markdown formatting when fetching page content?▼

Yes, the SDK preserves enhanced Notion Markdown formatting and data-source URLs when fetching page content. It also attempts JSON parsing of tool outputs to return structured, easily consumable JSON responses for your Python application.

What are the limitations of using a typed async SDK for Notion automation?▼

Limitations include dependency on MCP-exposed Notion tools and OAuth token management. The SDK returns JSON-parsed responses only when available, meaning some complex Notion outputs may remain as raw text rather than structured data.