Skip to content
cccskills
FreePublished on GitHubEnglish overview

notion

Search and read Notion pages, create new pages, and update workspace content through Notion MCP, a server connection for agent tools. Discover available operations first and confirm user intent before making changes.

OriginalShow the original description

Search, read, create, and update Notion pages via the Notion MCP.

Works withNotion

Run score Not tested

See how to install

Good for

  • Find pages in a Notion workspace
  • Read existing Notion page content
  • Create a new Notion page
  • Update pages or database content

Overview

What it does

This skill helps you find and read Notion pages, create new pages, and update existing content. It works through Notion MCP, a server connection that lets an agent use external tools to access pages, databases, and workspace information. Before carrying out a request, it checks which operations the connection provides and what input each one requires.

When it helps

Use it to find information saved in Notion during a conversation, review an existing page, or update its contents. It also supports creating pages and changing databases or blocks within pages. When reading results, you can check creation and edit times in both UTC and your local time.

Example requests

  • “Find the Notion page for this project and read its contents.”
  • “Create a new Notion page using these notes.”
  • “Update the contents of this page.”

Notes

You need notion-cli and a connection to the hosted Notion MCP server. Initial setup requires your authorization. The skill confirms your intent before changing pages, databases, or blocks. Available operations are checked through the connection’s tool list. Persistent authentication failures require refreshing the connection or authorizing it again.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Document check

AI checked the SKILL.md for operations that need care and for setup requirements. The score comes only from actually running the skill (hands-on test).

SafetyAre sending data, deleting files, and running commands disclosed?
AGoodIt requires confirming intent before changes and prohibits manually editing the credentials file.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingFirst-use authorization is documented, but installation instructions for notion-cli and authd are absent.

Not counted in the score. Rated by AI (OpenAI Codex) as of Oct 24, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (3)

  • SKILL.md2.6 KB
  • connector_auth_config.yaml212 B
  • manifest.yaml2.9 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Notion

Purpose

Interact with Notion pages, databases, and workspace content via the hosted Notion MCP server (https://mcp.notion.com/mcp).

Tooling

Use exec to run:

notion-cli <subcommand> [options]

Connection management

notion-cli status
notion-cli authorize-url
notion-cli exchange-code --code <code> [--redirect-uri <url>]
notion-cli refresh
notion-cli disconnect

MCP operations

notion-cli list-tools
notion-cli call-tool --name <tool> --arguments-json '<json-object>'

--arguments-json must be a JSON object; arrays or scalars are rejected. Use list-tools first to discover the tool catalogue and each tool's
input_schema.

Auth

OAuth is handled by authd via Dynamic Client Registration + PKCE (S256). The access token is stored at $JARVIS_HOME/user/auth/notion.json. Do not hand-edit this file.

First-use setup flow

  1. Run notion-cli status.
  2. If status is not_connected, run notion-cli authorize-url. When connect_url is present, replace <connect_url> with the returned URL and share exactly this Markdown link: [Connect Notion](<connect_url>); do not paste the raw URL separately. Wait for the user to complete authorization.
  3. After the user authorizes, the browser is redirected via the Muse relay back to this VM, and authd completes the code exchange automatically. The agent resumes once the token lands.
  4. Re-run notion-cli status. When status flips to connected the output also includes the discovered MCP tool catalogue.

For manual environments where the relay is not wired up, call notion-cli exchange-code --code <auth-code> after receiving the code.

Operating Rules

  1. Run notion-cli status before any MCP work. If not connected, complete the setup flow first.
  2. Call list-tools before call-tool unless you already know the tool name and its argument shape. Never guess tool names.
  3. arguments-json must be a JSON object; wrap every argument appropriately.
  4. Confirm user intent before tool calls that mutate Notion pages, databases, or blocks.
  5. Token refresh happens automatically on 401. If call-tool keeps failing with unauthorized, run notion-cli refresh explicitly or ask the user to re-authorize.
  6. Read results preserve Notion's raw date fields and add semantic UTC and user-local forms for record creation/edit times and timed date properties. Date-only properties remain dates.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

3d-object

FreeSummary

Create a 3D object with three.js, inspect it from every angle in an interactive viewer, and download it as OBJ + MTL or GLB for use in other 3D applications.

  • Create a 3D object and inspect it from every angle
  • Export a model for further editing in Blender
  • Review an object's silhouette and materials
asgeirtj/system_prompts_leaks70.1KUpdated Oct 23, 2026

action-items

FreeSummary

Maintain a private task list with deadlines, next steps, waiting parties, and blockers. Update progress and dependencies, merge duplicate items, and archive closed tasks so ongoing commitments stay clear and easy to follow.

  • Record tasks and commitments with deadlines
  • Track pending replies and reasons work cannot proceed
  • Update task dependencies when prerequisites are completed
asgeirtj/system_prompts_leaks70.1KUpdated Oct 23, 2026

agents

FreeSummary

Coordinate a task from a verifiable goal through completion. Handle work directly or split independent tasks across separate agent sessions, track progress, verify results, and arrange pull request merging when included in the goal.

  • Split independent tasks across agents
  • Check progress across ongoing tasks
  • Resume a previously started project
asgeirtj/system_prompts_leaks70.1KUpdated Oct 23, 2026

animated-video

FreeSummary

Create animated HTML pages with smooth scene transitions and playback controls. An editable timeline lets users adjust scene lengths and speeds, with fixed landscape or portrait layouts prepared for video export.

  • Create an animated product walkthrough
  • Explain a message through moving text and graphics
  • Build a portrait animation for video export
asgeirtj/system_prompts_leaks70.1KUpdated Oct 23, 2026

apple_healthkit

FreeSummary

Review synced Apple Health records, including steps, heart rate, sleep, and workouts. Retrieve daily summaries or detailed samples for a chosen period, and check sync status and missing data before interpreting the results.

  • Review daily steps and heart rate over time
  • Check sleep stages, duration, and awakenings
  • Review workout duration, distance, and calories
asgeirtj/system_prompts_leaks70.1KUpdated Oct 23, 2026

Create and edit Word documents and templates, reorganize text, replace images, and work with tracked changes or comments. Apply proper headings and lists, then render every page to check its appearance before delivery.

  • Create a structured Word document
  • Reorganize content in an existing document
  • Replace images or text in a document
asgeirtj/system_prompts_leaks70.1KUpdated Oct 23, 2026

See all skills by asgeirtj

Report a problem with this skill