Run any Skill in Manus with one click

second-brain-notion-api

Stars4

Forks1

UpdatedJune 28, 2026 at 18:45

Read and write the user's Notion Second Brain through the Notion API instead of MCP. Use when the user says SECOND BRAIN | Notion API, asks to read or write SB - Tasks, SB - Deals, or SB - Ideas with local API access, or when the Notion MCP connector is unavailable, indirect, or plan-gated.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Run Skill in Manus

Source

marcocello

marcocello/dot-codex

View GitHub Repository View Creator Repositories

Download

Run Skill in Manus

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

File Explorer

3 files

SKILL.md

readonly

name	second-brain-notion-api
description	Read and write the user's Notion Second Brain through the Notion API instead of MCP. Use when the user says SECOND BRAIN \| Notion API, asks to read or write SB - Tasks, SB - Deals, or SB - Ideas with local API access, or when the Notion MCP connector is unavailable, indirect, or plan-gated.

Second Brain Notion API

Use this skill for direct Notion API operations on the Second Brain tables defined in docs/secondbrain.md.

Safety

Never hardcode Notion credentials in repo files.
Read the integration token only from the local plaintext token file: $HOME/.config/codex/notion_secondbrain_token.
Do not print, summarize, or persist the token.
If no token is available, stop and ask the user to create that file.
Use the script for reads and writes instead of manually retyping API requests.

Script

Run:

python skills/second-brain-notion-api/scripts/notion_secondbrain.py --help

Common commands:

python skills/second-brain-notion-api/scripts/notion_secondbrain.py list tasks
python skills/second-brain-notion-api/scripts/notion_secondbrain.py create-task \
  --title "Follow up with Mario" --status Active --priority Medium
python skills/second-brain-notion-api/scripts/notion_secondbrain.py create-idea \
  --title "Granola insight" --source Granola --status Review

The script outputs compact JSON. Use --raw for full Notion API responses when debugging.

Tables

Use only the canonical Second Brain tables unless the user explicitly asks for schema work:

tasks -> SB - Tasks
deals -> SB - Deals
ideas -> SB - Ideas

At the beginning of each interaction, read or confirm the current data-source IDs for these tables from docs/secondbrain.md, the live Notion structure, or user-provided context before running write operations.

Workflow

Read docs/secondbrain.md for the current table contract.
Use the script with the token stored in $HOME/.config/codex/notion_secondbrain_token.
For writes, create the narrowest row that matches the user's request.
For uncertain derived rows, use Needs Review, Proposed, or low confidence.
Report the changed table, row title, and resulting page URL if available.

Fallback

If the API rejects a property name or select value, do not invent a new schema. Return the exact attempted table, fields, values, and API error so the schema can be adjusted deliberately.

More from this repository

same repository

coding-app-improvement-review

marcocello/dot-codex

Review a target app or project's feature specs, proof plans, proof evidence, successful tests, evaluator results, and user corrections to suggest app-specific improvements, new features, proof hardening, and reusable harness lessons without applying changes. Use when Codex should manually analyze whether features, proofs, and successful checks make sense and produce suggestions for the app/project or for dot-codex harness evolution.

2026-07-064

coding-app-to-features

marcocello/dot-codex

Turn an overall app description into a sharper app brief, bootstrap repo-level docs, create a series of features, executable proof packages, and the feature queue. Use for greenfield work when the user has an app idea and wants Codex to initialize the project before returning to feature execution. Use the `research` skill when assumptions need external evidence.

2026-07-064

coding-autonomous-execute

marcocello/dot-codex

Execute a feature queue, one feature, or a stubborn issue fix through a Codex Goal with explicit PROOF.md verification, evaluator judgment, bounded repair, and queue progress updates. Use when the user asks for autonomous execution, keep-going-until-done behavior, queue completion, or repeated repair after coding-feature-execute or coding-repair.

2026-07-064

coding-feature-evaluator

marcocello/dot-codex

Evaluate whether a completed feature or issue fix is actually done using a read-only skeptical review of FEATURE.md, PROOF.md, primary proof results, gate results, architecture fit, and anti-gaming risks. This is the done judge, not the test runner. Use after coding-feature-execute, coding-repair, or coding-autonomous-execute before marking work complete.

2026-07-064

coding-feature-execute

marcocello/dot-codex

Implement one feature end-to-end in Codex App using FEATURE.md for desired behavior, PROOF.md for done criteria, existing repo skills, red/green proof-first work, deterministic validation, mandatory backend/frontend/WordPress domain-skill handoff, and bounded repair. Use when a feature contract and proof contract are ready or need to be made ready before delivery.

2026-07-064

coding-feature-quality

marcocello/dot-codex

Review FEATURE_DIR/FEATURE.md and FEATURE_DIR/PROOF.md before non-trivial implementation for ambiguity, edge cases, testability, proof quality, and architecture conflicts without adding framework phases.

2026-07-064

name	second-brain-notion-api
description	Read and write the user's Notion Second Brain through the Notion API instead of MCP. Use when the user says SECOND BRAIN \| Notion API, asks to read or write SB - Tasks, SB - Deals, or SB - Ideas with local API access, or when the Notion MCP connector is unavailable, indirect, or plan-gated.

Second Brain Notion API

Use this skill for direct Notion API operations on the Second Brain tables defined in docs/secondbrain.md.

Safety

Never hardcode Notion credentials in repo files.
Read the integration token only from the local plaintext token file: $HOME/.config/codex/notion_secondbrain_token.
Do not print, summarize, or persist the token.
If no token is available, stop and ask the user to create that file.
Use the script for reads and writes instead of manually retyping API requests.

Script

Run:

python skills/second-brain-notion-api/scripts/notion_secondbrain.py --help

Common commands:

python skills/second-brain-notion-api/scripts/notion_secondbrain.py list tasks
python skills/second-brain-notion-api/scripts/notion_secondbrain.py create-task \
  --title "Follow up with Mario" --status Active --priority Medium
python skills/second-brain-notion-api/scripts/notion_secondbrain.py create-idea \
  --title "Granola insight" --source Granola --status Review

The script outputs compact JSON. Use --raw for full Notion API responses when debugging.

Tables

Use only the canonical Second Brain tables unless the user explicitly asks for schema work:

tasks -> SB - Tasks
deals -> SB - Deals
ideas -> SB - Ideas

Workflow

Read docs/secondbrain.md for the current table contract.
Use the script with the token stored in $HOME/.config/codex/notion_secondbrain_token.
For writes, create the narrowest row that matches the user's request.
For uncertain derived rows, use Needs Review, Proposed, or low confidence.
Report the changed table, row title, and resulting page URL if available.

Fallback

If the API rejects a property name or select value, do not invent a new schema. Return the exact attempted table, fields, values, and API error so the schema can be adjusted deliberately.