ClawTrust
7.3k Downloads
Overview
Provides managed OAuth access to the Notion API through the Maton gateway, enabling agents or applications to search, query, and modify Notion workspaces (databases/data sources, pages, blocks, users) without handling the raw OAuth flow directly.
Key Advantages
1.Covers most core Notion operations: search, databases/data sources, pages, blocks, and users.
2.Managed OAuth flow via Maton, so consumers only need an API key (MATON_API_KEY) instead of implementing Notion OAuth themselves.
3.Simple gateway pattern: same path structure as native Notion API with a consistent base URL and automatic token injection.
4.Good documentation quality with concrete Python and JavaScript examples, including connection management (list/create/get/delete).
5.Supports newer Notion concepts like data sources vs databases, with explicit guidance on how to use them together (GET /databases to obtain data_sources IDs).
Use Cases
- Building agents that search and summarize Notion pages (e.g., meeting notes, project docs) on demand.
- Automating creation and updating of pages or database entries based on user instructions or external events.
- Managing structured data in Notion databases/data sources (e.g., tasks, CRM records, knowledge bases) via filters, sorts, and pagination.
- Appending or modifying block content (e.g., adding meeting minutes, updating to-do lists, or inserting new sections into existing documents).
- Workspace administration helpers such as listing users, getting the current user, or cleaning up/archive flows for old content.
Evaluation Scores
8.0
/ 10
Reliability
7.5
Functionality
9.0
Usability
8.8
Safety
6.5
Performance
8.0
Compatibility
8.5
Based on 1 evaluation · Latest: 3/19/2026
Download Trend
Loading...
Evaluation History (1)
8.0/103/19/2026▼
OS: darwin-x64LLM: openai/gpt-5-nano
**Quick judgment**
A mature, full-featured Notion integration skill that exposes a large portion of the Notion API via a managed OAuth gateway. Strong choice when you need robust programmatic access to Notion (search, structured data, page/block management) and are comfortable depending on an external proxy service (Maton).
**Strengths**
- Broad coverage of Notion capabilities: search, databases vs data sources, pages, blocks, and users.
- Managed OAuth with Maton significantly reduces integration overhead for clients.
- Clear documentation with step-by-step Python/JS examples and explicit header requirements.
- Supports newer Notion concepts (data sources) and documents common patterns like querying and updating schema.
**Key risks and limitations**
- **External dependency**: All operations go through Maton’s gateway and control plane; reliability and latency depend on both Maton and Notion.
- **Destructive operations**: Supports updating schemas, archiving pages, and deleting blocks. Misuse or poorly constrained agent behavior can cause data loss or confusing schema changes.
- **Security and privacy**: Requires a powerful API key plus workspace OAuth connection; improper key management or overly broad access could expose sensitive workspace data.
- **Rate limiting and errors**: Subject to Maton rate limits (10 req/sec per account) and underlying Notion API errors; applications must handle 4xx/5xx and 429 responses gracefully.
**Recommended scenarios**
- Agents that act as a Notion “assistant” for reading, summarizing, and lightly editing workspace content.
- Workflow automation where Notion is a system of record (task updates, CRM entries, status changes, structured reporting).
- Developer or ops tools that need to query and manipulate Notion databases/data sources in a controlled environment with well-defined prompts and guardrails.
Less suited for high-risk contexts where unrestricted agents might massively refactor or delete content, unless you implement strict prompting, allow-listing of operations, and possibly read-only patterns (e.g., disallow schema changes and destructive endpoints).
Comments (0)
No comments yet. Be the first!