本文へ移動
cccskills
無料GitHub で公開

notion

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

obra/muse-skills
インストール方法を見る

含まれるファイル（3）

  • SKILL.md2.5 KB
  • connector_auth_config.yaml212 B
  • manifest.yaml3.0 KB

SKILL.md（原文）

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

ログインしてレビューを書く

同じリポジトリのスキル

概要と使いどころ

apple_healthkit

無料

The user's synced Apple Health (HealthKit) data: daily metrics (steps, distance, calories, heart rate, HRV, VO2max), sleep sessions (stages, quality, efficiency), and workouts.

日本語の概要は準備中です。原文の説明を表示しています。

obra/muse-skills202026年10月12日 更新

artifact_document

無料

Create, read, edit, or manipulate Word documents (.docx) and Word templates (.dotx). Use whenever a build task's artifact kind is document with the default docx output, or the task mentions a Word doc, .docx, or .dotx, extracts or reorganizes content from one, inserts or replaces images, does find-and-replace in one, or works with tracked changes (redlines) or comments. Covers python-docx generation, raw OOXML editing of existing files, document structure and formatting, and render verification. Not for PDFs, spreadsheets, or Google Docs.

日本語の概要は準備中です。原文の説明を表示しています。

obra/muse-skills202026年10月12日 更新

artifact_markdown

無料

Build or revise a plain markdown file (md) deliverable such as notes, a README, meeting minutes, documentation, or text the user will edit or paste elsewhere. Use whenever a build task's artifact kind is markdown. Covers markdown formatting conventions and read-back verification.

日本語の概要は準備中です。原文の説明を表示しています。

obra/muse-skills202026年10月12日 更新

artifact_pdf

無料

Build, revise, or manipulate a fixed-layout PDF (report, guide, one-pager, printable document). Use whenever a build task's artifact kind is pdf, a document build's output format is pdf, or the task reads, merges, splits, crops, or fills an existing PDF, including fillable AcroForms. Covers authoring the print-CSS HTML source, rendering, the geometry and validation gates, existing-PDF manipulation and form filling, and delivery under workspace/your_files.

日本語の概要は準備中です。原文の説明を表示しています。

obra/muse-skills202026年10月12日 更新

artifact_presentation

無料

Build or revise a slide deck (pptx by default; pdf or html on request). Use whenever a build task's artifact kind is presentation, or the user asks for a deck, slides, or a presentation. Covers per-slide HTML authoring, the StylePlan theme system, font embedding, deck assembly, render gates, and the PPTX export.

日本語の概要は準備中です。原文の説明を表示しています。

obra/muse-skills202026年10月12日 更新

artifact_spreadsheet

無料

Create, read, edit, fix, or clean spreadsheet files (.xlsx, .xlsm, .csv, .tsv). Use whenever a build task's artifact kind is spreadsheet, or the task names a spreadsheet file and wants something done to it or produced from it, including restructuring messy tabular data into a proper workbook. Covers openpyxl generation, formulas and recalculation, editing existing workbooks, and the validation gates. Not for tasks whose deliverable is a document, report, or web page that merely contains a table.

日本語の概要は準備中です。原文の説明を表示しています。

obra/muse-skills202026年10月12日 更新

obra のスキルをすべて見る

このスキルの問題を報告する