paper-to-notion

Paper To Notion Skill

English | 简体中文

Evidence-driven paper reading for Codex, Claude, WorkBuddy, and compatible MCP/CLI agent runtimes. This skill turns an academic paper into a durable Notion record: a lean database row for indexing, plus a rich report page with grounded evidence, formulas, figures, tables, code checks, limitations, and reproducibility notes.

The default report language is English. Chinese and bilingual reports are supported when requested.

Connect Notion First

This skill writes to Notion through the agent runtime's authenticated Notion connector. For normal Codex or Claude use, do not create a Notion integration token and do not paste secrets into prompts.

Connector links and references:

• Codex Marketplace: Notion plugin
• Claude Notion connector
• Notion MCP overview
• Connecting to Notion MCP
• Notion MCP security best practices
• Codex MCP docs
• Claude connectors docs

Before installing or running the skill:

• Codex: Open the Codex Marketplace Notion plugin and install it. The marketplace page lists the install command:

  npx codex-marketplace add openai/plugins/plugins/notion --plugin
  

  After installing, restart or reload Codex, complete the Notion OAuth flow when prompted, and use /mcp to confirm that Notion is connected before running the setup prompt below.

  If you prefer a manual MCP setup, add the official Notion MCP server to ~/.codex/config.toml, then run the OAuth login:

  [mcp_servers.notion]
  url = "https://mcp.notion.com/mcp"
  

  codex mcp login notion
  

  In the Codex TUI, use /mcp to confirm that notion is connected before running the setup prompt below.

• Claude Code: Add the official Notion MCP server, then authenticate from Claude Code:

  claude mcp add --transport http notion https://mcp.notion.com/mcp
  

  Then run /mcp inside Claude Code and complete the OAuth flow. After that, run the plugin setup command below.

• Claude / Claude Desktop: Open the official Claude Notion connector, or use Claude's Connectors UI: Settings > Connectors, add or select Notion, and complete OAuth. The connector provides read/write access for searching, creating, editing, and organizing Notion content from Claude.

• No connector yet: The skill can still generate local reports, evidence packs, and notion_payload.json, but it should stop before mutating Notion. Use the REST fallback only when you explicitly choose token-based publishing.

Notion's recommended remote MCP endpoint is https://mcp.notion.com/mcp. The legacy SSE endpoint is https://mcp.notion.com/sse; use it only when a client does not support streamable HTTP.

The setup flow will search for an existing Paper Reading Library database first. If none is found and the connector can create databases, it will create one and save the database IDs in .paper-notion/config.json.

Install

Option 1: Agent-Assisted Install

If you already use Codex, the easiest path is to ask the agent to install the skill and run the first setup pass for you.

For Codex, paste this into a Codex session:

Please install this skill:
https://github.com/Guesswhat-Studio/paper-to-notion-skill

Install it into my Codex skills directory, then use $paper-to-notion-skill to set up my Notion paper reading workflow. Please handle the setup automatically: prepare the local Python environment, create or reuse the Paper Reading Library database, validate the schema, run the Attention Is All You Need smoke test, save .paper-notion/config.json, and only report the final database/page URLs, validation status, and any action I must take.

Option 2: Claude Code Plugin Install

Claude Code plugin commands are handled by the Claude Code CLI. The model cannot run /plugin marketplace add or /plugin install for you from inside a chat session. Run the install command yourself, then ask the installed skill to set up the workflow.

In an interactive Claude Code session, run these one at a time. Press Enter after each command and wait for it to finish before typing the next one:

/plugin marketplace add https://github.com/Guesswhat-Studio/paper-to-notion-skill

/plugin install paper-to-notion@guesswhat-paper-tools

/reload-plugins

/paper-to-notion:paper-to-notion-skill set up my Notion paper reading workflow

From a terminal, use: