notion

Access Notion pages, databases, and blocks via the REST API.

8|1|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/mnlt/teleport --skill notion-mnlt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion
Source: https://github.com/mnlt/teleport/tree/main/skills/notion
Command: npx skills add https://github.com/mnlt/teleport --skill notion-mnlt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Notion requires programmatic access to read and write pages, databases, and blocks via the REST API, enabling agents to interact with Notion workspaces without the MCP server.

Core Features & Use Cases

  • Direct REST access to Notion pages, databases, blocks, and search for tasks like querying databases with filters, creating or updating pages, and appending content to blocks.
  • Real-world scenario: automate updating a project page when status changes or extract database entries for reporting.
  • Use case: synchronize a Notion workspace with external tools to keep notes and task lists up to date.

Quick Start

Ask the agent to read or update a Notion page, database, or block via the REST API.

Frequently Asked Questions about notion

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

FAQPage Schema
How do I query a Notion database with filters via the REST API?

You can query a Notion database with filters by making a POST request to the Notion REST API endpoint. This enables programmatic reading of database entries to automate tasks like extracting data for reporting or synchronizing workspaces.

Can I create and update Notion pages programmatically without the MCP server?

Yes, you can create and update Notion pages without the MCP server by sending direct REST API requests. You need a Notion API key and the Notion-Version header to handle permissions and manipulate page objects programmatically.

What is required to append blocks to a Notion page using the API?

To append blocks to a Notion page via the API, you need a Notion API key and the Notion-Version header. You send REST requests to the blocks endpoint to programmatically add content, while the system manages object models and rate limits.

Does the Notion REST API handle rate limits and permissions automatically?

When interacting with Notion data via the REST API, the system handles rate limits and permissions according to the object models described in the API docs. You must provide a Notion API key and the Notion-Version header to ensure authenticated, compliant access.

What is the best way to synchronize external tools with a Notion workspace?

Using direct REST API access to read and write pages, databases, and blocks is the best way to synchronize external tools with a Notion workspace. This programmatic approach automates updates to keep notes and task lists current without the MCP server.

Why do I need a Notion API key and the Notion-Version header for workspace searches?

A Notion API key and the Notion-Version header are required for workspace searches to authenticate REST API requests and ensure compatibility with current object models. This enables secure, programmatic querying of pages and databases across the workspace.