skills.rest
manojbajaj95
manojbajaj95COMMUNITY
Explore all skills by this author →
𝕏@mbajaj_GitHub

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
One-click install
npx skills add https://github.com/manojbajaj95/mcp-skill --skill notion-manojbajaj95
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Software Engineering Skills→
vellum-aivellum-ai
1.0k

notion

Read Notion pages and databases via the Notion API with stored credentials.

Official
Advanced
juanrejuanre
3

structured-output

Extract structured data from LLM responses with JSON Schema validation.

Community
Intermediate
SstoboSstobo
25

Convex Agents Tools

Define Convex-aware tools with createTool and wire them into agents.

Community
Intermediate
DavidTejuDavidTeju
9

querying-and-updating-notion

Determine when to use MCP tools versus direct Notion API calls.

Community
Intermediate