LN

lox/notion-cli

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

37 stars 16 forks Качество 68 Тренд 20MIT

CLI for Notion с использованием протокола Model Context Protocol (MCP)

Обзор

Интерфейс командной строки для Notion с использованием удаленного MCP (Model Context Protocol). Вдохновленный линейным кли - оставайтесь в терминале, управляя рабочим пространством Notion. - включает в себя навык, который позволяет агентам искать, создавать и управлять рабочим пространством Notion вместе с вашим кодом. Аргумент принимает URL, ID или имя страницы. Архив страниц принимает URL страницы или идентификатор страницы и перемещает эту страницу в мусор через официальный API. Для этого требуется официальный токен API, настроенный через настройку auth api или NOTION API TOKEN. Просмотр страницы показывает открытые комментарии на уровне страницы и обсуждения встроенных блоков по умолчанию. Внутренняя дискуссия осуществляется в контексте, с якорным текстом, завернутым в [[...]], и обсуждение показано непосредственно под ним. Используйте - no-comments для подавления комментариев, -raw для проверки оригинальной разметки Notion и -json для возврата страницы плюс массив комментариев. Аргумент принимает URL, ID или имя. Свойства даты используют расширенный ключевой формат: date: :start, date: :end.

Обзор (машинный перевод)

Интерфейс командной строки для Notion с использованием удаленного MCP (Model Context Protocol).

Вдохновленный линейным кли - оставайтесь в терминале, управляя рабочим пространством Notion.

** Отлично работает с агентами ИИ** — включает в себя навык, который позволяет агентам искать, создавать и управлять рабочим пространством Notion вместе с вашим кодом.

##Установка

Источник

###Строим локально

Быстрый старт

Команды

Аутентификация

Страницы

Аргумент принимает URL, ID или имя страницы.

page archive принимает URL страницы или идентификатор страницы и перемещает эту страницу в мусор через официальный API. Для этого требуется официальный токен API, настроенный через auth api setup или NOTION_API_TOKEN.

page view показывает открытые комментарии на уровне страницы и обсуждения встроенных блоков по умолчанию. Внутренняя дискуссия осуществляется в контексте, с якорным текстом, завернутым в [[...]], и обсуждение показано непосредственно под ним. Используйте --no-comments для подавления комментариев, --raw для проверки оригинальной разметки Notion и --json для возврата страницы плюс массив Comments.

page upload и page sync поддерживают локальную загрузку изображений для автономных линий разметки, таких как .

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

notion-cli

A command-line interface for Notion using the remote MCP (Model Context Protocol).

Inspired by linear-cli - stay in the terminal while managing your Notion workspace.

Works great with AI agents — includes a skill that lets agents search, create, and manage your Notion workspace alongside your code.

Installation

From Source

go install github.com/lox/notion-cli@latest

Build Locally

git clone https://github.com/lox/notion-cli
cd notion-cli
mise run build

Quick Start

# Authenticate with Notion (opens browser for OAuth)
notion-cli auth login

# Search your workspace
notion-cli search "meeting notes"

# View a page with open comments inline by default
notion-cli page view "https://notion.so/My-Page-abc123"

# Hide page and block comments when you only want the body
notion-cli page view "Meeting Notes" --no-comments

# List your pages
notion-cli page list

# Create a page
notion-cli page create --title "New Page" --content "# Hello World"

Commands

Authentication

notion-cli auth login      # Authenticate with Notion via OAuth
notion-cli auth refresh    # Refresh the access token
notion-cli auth status     # Show authentication status
notion-cli auth logout     # Clear stored credentials

# Official API fallback auth for features MCP cannot handle directly
notion-cli auth api setup     # Opens the internal integrations page, prompts for token, warns if format looks wrong
notion-cli auth api status
notion-cli auth api verify
notion-cli auth api unset

Pages

notion-cli page list                           # List pages
notion-cli page list --limit 50                # Limit results
notion-cli page list --json                    # Output as JSON

notion-cli page view                     # View page content with comments
notion-cli page view  --no-comments      # Hide page and block comments
notion-cli page view  --raw              # View raw Notion markup
notion-cli page view  --json             # Output as JSON

notion-cli page create --title "Title"         # Create a page
notion-cli page create --title "T" --content "Body text"
notion-cli page create --title "T" --parent 
notion-cli page archive        # Archive a page via the official API

# Upload a markdown file as a new page
notion-cli page upload ./document.md                        # Title from # heading or filename
notion-cli page upload ./document.md --title "Custom Title" # Explicit title
notion-cli page upload ./document.md --parent "Engineering" # Parent by name or ID
notion-cli page upload ./document.md --parent-db     # Upload as database entry
notion-cli page upload ./document.md --icon "📄"             # Set emoji icon
Открыть полный README на GitHub

Установка

npx skills add lox/notion-cli
Новичок в MCP? Начните с руководства на mcpskill.org →