# io.github.ai-aviate/better-notion

> Operate Notion with a single Markdown document — read, create, and update pages in one call.

- name: io.github.ai-aviate/better-notion
- version: 0.3.2
- connection class: L0 (run_local_package)
- trust: 76/100
- quality: –/100 (not scored)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.ai-aviate%2Fbetter-notion
- tools: https://api.protogrid.dev/v1/servers/io.github.ai-aviate%2Fbetter-notion/tools

**Runs on your machine: something must execute the package.** Only local packages are published (npm, PyPI, OCI, …). The registry never executes them, so tools are unknown until you run it.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "better-notion": {
      "command": "npx",
      "args": [
        "-y",
        "better-mcp-notion@0.3.2"
      ],
      "env": {
        "NOTION_API_KEY": "${NOTION_API_KEY}"
      }
    }
  }
}
```

Placeholders to fill: `${NOTION_API_KEY}`.

## Trust

- hygiene: 100
- liveness: n/a
- freshness: 45
- provenance: 80
- drivers: +repository +namespace-matches-repo ~liveness-unmeasured -stale-243d
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality –/100 (not scored)

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

### protocol: n/a (weight 25)

- n/a `protocol.modern`, `protocol.stateless`, `protocol.transport`, `protocol.list_ttl`: no remote answered a protocol handshake (not probed yet, unreachable, or local-only)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: n/a (weight 30)

- n/a `tools.descriptions`, `tools.description_length`, `tools.schemas`, `tools.annotations`, `tools.directory_hints`, `tools.token_cost`, `tools.api_dump`: tool list unknown (behind auth, not probed, or empty)

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool list unknown

### dependencies: 50 (weight 15)

- warn `deps.known_vulns`: 6 advisories of lower severity or without a published fix: GHSA-238p-pmpm-9mq7 in katex@0.12.0 (indirect, fixed in 0.18.2), GHSA-3wc5-fcw2-2329 in katex@0.12.0 (indirect, fixed in 0.16.10), GHSA-64fm-8hw2-v72w in katex@0.12.0 (indirect, fixed in 0.16.10), ...
- fail `deps.mcp_sdk_version`: @modelcontextprotocol/sdk 1.30.1 has 1 known advisory (GHSA-6qxp-vccf-f47h); update @modelcontextprotocol/sdk to 1.31.0 or later
- pass `deps.resolvable`: better-mcp-notion@0.3.2 resolved: 177 packages

- tools: unknown
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.ai-aviate/better-notion.svg)](https://protogrid.dev/servers/io.github.ai-aviate/better-notion)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Dependencies

- npm better-mcp-notion@0.3.2: resolved, 176 dependencies, MCP SDK @modelcontextprotocol/sdk 1.30.1
  - GHSA-6qxp-vccf-f47h (high) in `` @modelcontextprotocol/sdk@1.30.1 ``, direct, fixed in `` 1.31.0 ``, advisory summary: "MCP TypeScript SDK: OAuth client could send credentials to an authorization server chosen by the MCP server" https://osv.dev/vulnerability/GHSA-6qxp-vccf-f47h
  - GHSA-3wc5-fcw2-2329 (moderate) in `` katex@0.12.0 ``, indirect, fixed in `` 0.16.10 ``, advisory summary: "KaTeX missing normalization of the protocol in URLs allows bypassing forbidden protocols" https://osv.dev/vulnerability/GHSA-3wc5-fcw2-2329
  - GHSA-64fm-8hw2-v72w (moderate) in `` katex@0.12.0 ``, indirect, fixed in `` 0.16.10 ``, advisory summary: "KaTeX's maxExpand bypassed by \`\\edef\`" https://osv.dev/vulnerability/GHSA-64fm-8hw2-v72w
  - GHSA-cg87-wmx4-v546 (moderate) in `` katex@0.12.0 ``, indirect, fixed in `` 0.16.21 ``, advisory summary: "KaTeX \\htmlData does not validate attribute names" https://osv.dev/vulnerability/GHSA-cg87-wmx4-v546
  - GHSA-f98w-7cxr-ff2h (moderate) in `` katex@0.12.0 ``, indirect, fixed in `` 0.16.10 ``, advisory summary: "KaTeX's \`\\includegraphics\` does not escape filename" https://osv.dev/vulnerability/GHSA-f98w-7cxr-ff2h
  - GHSA-hp3w-g68c-fv3c (moderate) in `` sprintf-js@1.0.3 ``, indirect, no fix yet, advisory summary: "sprintf-js vulnerable to denial of service through unbounded precision specifiers" https://osv.dev/vulnerability/GHSA-hp3w-g68c-fv3c
  - GHSA-238p-pmpm-9mq7 (low) in `` katex@0.12.0 ``, indirect, fixed in `` 0.18.2 ``, advisory summary: "KaTeX: Existing prototype pollution can bypass trust restrictions" https://osv.dev/vulnerability/GHSA-238p-pmpm-9mq7

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

_none_

## Packages

- npm better-mcp-notion@0.3.2 secrets: NOTION_API_KEY

## Tools (0)

_none observed_