Przejdź do treści
Biblioteka skilli
AI i agenci · Integracja z narzędziem

setup-notion

/setup-notion

Łączy Claude Code z oficjalnym hostowanym serwerem MCP Notion, przechodzi OAuth i sprawdza odczyt w docelowym workspace, bez zapisu.

Repozytorium
ai-analyst ↗
Licencja
MIT
Ostatnia zmiana repozytorium
30.09.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
4
Przestarzałość

Brak sygnałów. Repozytorium zmienione 30.09.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Łączy Claude Code z oficjalnym hostowanym serwerem MCP Notion, przechodzi OAuth i sprawdza odczyt w docelowym workspace, bez zapisu.

Oryginalny opis (EN)

Connect Claude Code to Notion's official hosted MCP, complete OAuth, verify the intended workspace with a read, and stop before any write. Use when the user asks to connect Notion, set up Notion, export to Notion, or diagnose an unavailable Notion connection.

Jak działa

  1. Purpose
  2. Current supported path
  3. Instructions
  4. Rules
Sekcje z nagłówków SKILL.md, w oryginale · 98 linii, 511 słów
Podgląd SKILL.md
---
name: setup-notion
description: >-
  Connect Claude Code to Notion's official hosted MCP, complete OAuth, verify the intended
  workspace with a read, and stop before any write. Use when the user asks to connect Notion,
  set up Notion, export to Notion, or diagnose an unavailable Notion connection.
---

# Setup Notion

## Purpose

Configure Notion's official hosted MCP for this project, help the user complete browser OAuth,
and verify the intended workspace before any content is created.

## Current supported path

- Official endpoint: `https://mcp.notion.com/mcp`
- Transport: remote HTTP
- Authentication: OAuth in the browser
- Project configuration: `.mcp.json`

Notion's hosted MCP does not currently support file uploads. Do not promise that a local chart or
other file can be uploaded through this server. Create the text page first. If the user needs an
attachment, they can add it manually or use a separately approved API workflow.

## Instructions

### 1. Inspect before changing configuration

1. Read `.mcp.json` if it exists.
2. Preserve every existing MCP server.
3. Check whether a Notion server already points to the official endpoint.
4. If Notion tools are already available, skip configuration and verify the connection.
5. Before editing anything, show the user the exact non-secret change and ask for approval.

Never replace the entire MCP configuration merely to add Notion.

### 2. Add the official server

After approval, add this project-local server entry while preserving the rest of `.mcp.json`:

```json
{
  "notion": {
    "type": "http",
    "url": "https://mcp.notion.com/mcp"
  }
}
```

An equivalent supported Claude Code command is:

```text
claude mcp add --transport http --scope project notion https://mcp.notion.com/mcp
```

Do not put tokens or credentials in the configuration.

### 3. Authenticate

If this session did not load the new server, tell the user to restart Claude Code. Then have the
user run `/mcp`, select Notion, and complete OAuth in the browser.

Before the user authorizes access, remind them to confirm:

- the Notion account;
- the workspace;
- whether that workspace is approved for the intended work; and
- that the connected client can act with the access granted to that user.

Do not claim that OAuth proves the destination or makes every future action safe.

### 4. Verify with a read

Ask the user for the title of a page they expect in the approved workspace. Use the available
Notion search tool to find it without changing anything.

Show the workspace and matching page titles. If the expected page is missing, the workspace is
wrong, or the tool call fails, stop and report the exact blocked step. Do not create a page.

### 5. Report the result

Report only what was verified:

```text
Notion connection
Server: official hosted MCP
Endpoint: https://mcp.notion.com/mcp
Workspace: [verified workspace, if exposed]
Read test: [page title found, or exact blocked step]
Ready for an approved write: [yes or no]
```

## Rules

1. Use only Notion's official hosted endpoint unless the user explicitly requests another server.
2. Preserve existing MCP servers.
3. Stop for approval before editing MCP configuration.
4. Never request or store a Notion API key for this OAuth path.
5. Verify the workspace with a read before any write.
6. Preview the destination and content before any later write.
7. Never claim that hosted Notion MCP can upload files.
8. If access is wrong, disconnect or revoke it rather than continuing with a nearby workspace.

Wersje

RepozytoriumWynikLicencja
Ta strona · ai-analyst-lab/ai-analyst100MIT
ai-analyst-lab/ai-analyst-plugin100MIT

Migawka bazy z 13.11.2026 · wersja paczki 141ba3ef0c49 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 1 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 86notion-connect
    Łączy agenta z oficjalnym hostowanym MCP Notion w celu wyszukiwania i pobierania stron, sprawdza albo odłącza to połączenie.
  • 100notion-connect
    Łączy środowisko agenta z oficjalnym hostowanym MCP Notion do wyszukiwania i pobierania stron, sprawdza stan połączenia i pozwala je odwołać.
  • 96notion
    Przeszukuje, czyta, tworzy i aktualizuje strony oraz bazy danych w Notion przez API.
  • 100notion
    Buduje integracje z API Notion: bazy i źródła danych, strony, bloki, wyszukiwanie i OAuth, do odczytu i zapisu danych, synchronizacji z innymi narzędziami i dashboardów.
  • 100mcp-server-notion
    Instaluje serwer MCP Notion do wyszukiwania stron, tworzenia ich i pracy z bazami danych oraz obsługuje jego narzędzia.
  • 100notion-cli
    Obsługuje Notion przez binarkę Go 4ier/notion-cli: wyszukiwanie, zapytania do baz danych, odczyt stron i eksport danych z poziomu terminala.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.