mingzeng21/dsh-notion
Connect dsh to Notion via the official Notion MCP (OAuth + PKCE): search, read, and write pages, databases, and comments through mcpnotion* tools.
dsh-notion-mcp connects DeepSeek Harness to Notion through the official Notion MCP server using OAuth 2.0. After a one-time browser authorisation your agent can search, read and write Notion pages, databases and comments through the standard mcpnotion* tools. It performs zero-config OAuth (dynamic client registration per RFC 7591, so there is no client_id or secret to copy), a one-time browser login (dsh notion login prints an authorization URL and waits for the callback on 127.0.0.1:53007), silent token refresh (access tokens ~8h, with the rotated refresh token persisted atomically) and terminal invalid_grant handling (an expired or rotated-away refresh token is cleared and re-authorisation requested, never retried). Tokens live in dsh's credential store, not in the repository.
Install
dsh plugin --profile web add dsh-notion-mcpThe npm package dsh-notion-mcp 0.1.0 was re-verified live on 2026-10-01 (the registry entry carries no repository field, so the name is taken from the README). Replace web with whichever profile you run the agent in (web/headless/tui). After installing, run dsh notion login to authorise.
Compatibility
Node 22.19+ or 24+; a dsh profile. Connects to the official Notion MCP server using OAuth 2.0 (authorization code + PKCE).
Details
- Repo: mingzeng21/dsh-notion
- Category: Notifications & Integrations
- Stars: 0
- Version: npm dsh-notion-mcp 0.1.0 (registry re-verified 2026-10-01; no repository field on the entry); MIT
- Last push: 2026-08-30
- First seen: 2026-08-15
Recent updates
The README documents the OAuth flow (RFC 7591 dynamic registration, PKCE, one-time browser login on 127.0.0.1:53007), silent refresh, invalid_grant handling, the credential-store rule, and a screenshot of the agent writing into Notion.
FAQ
- How do I install the Notion connector?
- dsh plugin --profile web add dsh-notion-mcp (substitute your profile); the npm package 0.1.0 was re-verified on 2026-10-01, then run dsh notion login.
- Do I need a Notion client ID/secret?
- No -- the README says dynamic client registration (RFC 7591) registers a client at runtime; you authorise once via dsh notion login.
- Where are tokens stored?
- In dsh's credential store, not the repository, per the README.
Alternatives
JohnXu22786/github-mcp · havingautism/dsh-notebooks · zhaoolee/notes