# Logics MCP Notion

> Install, configure, and use the Notion MCP server to connect MCP clients to Notion (read/query/update pages and databases). Use when wiring MCP clients to Notion. Use when this capability is needed.

- Skill: `tomevault-io/logics-mcp-notion` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/logics-mcp-notion`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/logics-mcp-notion/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/logics-mcp-notion

---


# Notion MCP

## Quick start
1) Create a Notion integration and connect the target pages/databases to it.
2) Add the MCP server config to your client (below).
3) Restart the client and test a simple query (search or retrieve a page).

### Standard MCP config (official server)
```json
{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "ntn_***"
      }
    }
  }
}
```

### Advanced auth (optional)
Use OpenAPI headers if you need custom auth/version headers:

```json
{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_***\", \"Notion-Version\": \"2025-09-03\" }"
      }
    }
  }
}
```

### HTTP transport (optional)
If your client needs HTTP transport:

```bash
npx @notionhq/notion-mcp-server --transport http --auth-token "your-secret-token"
```

The server will be available at `http://0.0.0.0:<port>/mcp`.

### Community alternative (optional)
If you need Markdown conversion output:

```json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token",
        "NOTION_MARKDOWN_CONVERSION": "true"
      }
    }
  }
}
```

## Usage flow (agent-side)
- Start with a safe read-only query: search or retrieve a known page.
- Validate permissions before attempting writes.
- Prefer small, targeted operations (avoid full-workspace scans).

## Safety
- Notion tokens grant workspace access; use least-privileged integrations.
- Prefer read-only integrations when possible.
- Avoid exposing tokens in logs or prompts.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/alexago83) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->