Notion connector for DeepSeek Harness: search, read, query, create, update, and append Notion pages and databases via six agent tools, with a Web settings page — configured once with an Integration Token.
Install
# from npm (prebuilt)
dsh plugin --profile web add dsh-notion-connector
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:zhengjy01/dsh-notion-connector
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
English | 中文
A Notion connector plugin for DeepSeek Harness. Configure an Integration Token once, and both the agent and the Web GUI settings page can operate your Notion workspace.
Features
- Agent tools (available automatically after configuration):
notion_search— search pages/databasesnotion_read_page— read page title, properties, and content blocks (nested blocks are read recursively, up to 200 blocks)notion_query_database— query database entries (filter / sorts / pagination)notion_create_page— create a page (under a page or a database)notion_update_page— update properties / archivenotion_append_blocks— append content blocks
- Web settings page: Settings → Notion — connection status, Token input (automatically validated and the workspace name is read on save), clear configuration, three-step guide
- Storage: the Token is stored in
~/.dsh/notion.json(permissions 0600); the browser interacts with the plugin through the loopback-only/api/dsh-notion-connector/*endpoints; API calls use Node's native fetch, with no shell dependency
Installation
dsh plugin --profile web add github:zhengjy01/dsh-notion-connector
Restart dsh web to activate the plugin.
Usage
- Open https://www.notion.so/my-integrations and create an internal integration; copy the Internal Integration Secret (starts with
secret_) - In Notion, Share the pages/databases you want to access with the integration
- In the GUI, go to Settings → Notion, paste the Token and save
- After that, just tell the agent things like "search for XX in Notion" or "save this content to Notion"
Development
pnpm install # esbuild / typescript / type dependencies
pnpm build # esbuild: lib/index.js (host) + lib/client.js (browser)
pnpm typecheck # tsc --noEmit
pnpm install:local # fast local dev install (copies to ~/.dsh/profiles/node_modules/dsh-notion-connector)
Limitations
- Pages/databases must be shared with the integration before they can be accessed
- The Token is stored in plaintext in a private file in your home directory (permissions 0600)
- This plugin is third-party code: review the source before installing, and only use it from trusted sources
License
MIT
Links
More in this category
vectorize-io/hindsight#coding-agents★ 42988
Hindsight, agent memory that learns: long-term project memory with auto recall and retain, knowledge pages, deep reflection, and per-repo memory banks.
volcengine/OpenViking#examples/dsh-memory-plugin★ 38990
OpenViking memory and context bundle for DeepSeek Harness: pre-step auto-recall and profile injection, session capture, `viking://` URI guarding, and recall/write memory tools backed by an OpenViking server.
agentscope-ai/ReMe#dsh★ 3534
Connects DeepSeek Harness to ReMe's local-first, self-evolving personal knowledge base: automatically captures completed main-agent conversations as user-owned Markdown memory, searches conversations and source material through reme_search with BM25, optional embeddings, and wikilink expansion, and schedules daily memory consolidation.
zilliztech/memsearch#MemSearch★ 2682
Shared Markdown memory for DSH and other coding agents, with automatic capture, pre-step context injection, searchable recall, and memory-to-skill self-evolution through a review panel.
vshulcz/deja-vu#extensions/dsh★ 1093
Reads the session files thirty-three other coding agents on this machine already wrote — Claude Code, Codex, Cursor, VS Code Copilot Chat, opencode, OpenClaw, Hermes, Kimi, Cline, Zed and more — including sessions from before it was installed: six tools (deja_recall, deja_session, deja_blame, deja_fix, deja_how, deja_remember), a /deja command, and optional automatic recall added to the runtime context. Local BM25 index, no LLM, no embeddings, no network (dsh plugin --profile web add dsh-deja).
adoresever/graph-memory★ 633
Traceable, searchable cross-session memory for DeepSeek Harness — conversation knowledge as typed graph nodes (TASK/SKILL/EVENT) and typed edges.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.