dsh-notion-connector
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
