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★ 60916
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★ 42209
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.
MemTensor/MemOS#memos-local-plugin★ 12392
Local-first memory plugin for DeepSeek Harness: layered L1/L2/L3 memory with automatic capture, manual memos_* retrieval tools, and a built-in memory viewer.
agentscope-ai/ReMe#dsh★ 3799
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★ 2873
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★ 1544
Cross-session memory and context recovery across forty-five other coding agents (45+) on this machine, reading session files they already wrote before install (Claude Code, Codex, Cursor, Windsurf, Trae, Antigravity, VS Code Copilot Chat, opencode, OpenClaw, Hermes, Kimi, Qoder, Cline, Zed, Magpie and more): six tools (deja_recall, deja_session, deja_blame, deja_fix, deja_how, deja_remember), a /deja command, and optional automatic recall injected into runtime context. Local BM25 CLI/MCP index, no LLM, no embeddings, no network (dsh plugin --profile web add dsh-deja).
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.