Skip to content
dsh marketplace

dsh-notion-connector

Verified

dsh-notion-connector · v0.1.1 · MIT · Web UI

Notion connector for DeepSeek Harness: Integration Token config (~/.dsh/notion.json, 0600), agent tools (notion_search / notion_read_page / notion_query_database / notion_create_page / notion_update_page / notion_append_blocks), and a Web GUI settings pag

Install

dsh plugin add dsh-notion-connector

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Readme

dsh-notion-connector

English | 中文

DeepSeek Harness 的 Notion 连接插件。配置一次 Integration Token 后，agent 与 Web GUI 设置页都可以操作你的 Notion 工作区。

功能

  • Agent 工具（配置后自动可用）：
    • notion_search — 搜索页面/数据库
    • notion_read_page — 读取页面标题、属性、内容块（嵌套递归，最多 200 块）
    • notion_query_database — 查询数据库条目（filter / sorts / 翻页）
    • notion_create_page — 创建页面（页面或数据库下）
    • notion_update_page — 更新属性 / 归档
    • notion_append_blocks — 追加内容块
  • Web 设置页：设置 → Notion — 连接状态、Token 粘贴（保存时自动校验并读取工作区名）、清除配置、三步指引
  • 存储：Token 存 ~/.dsh/notion.json（权限 0600）；通过 loopback-only 的 /api/dsh-notion-connector/* 与浏览器半交互；API 调用走 Node 原生 fetch，无 shell 依赖

安装

dsh plugin --profile web add github:zhengjy01/dsh-notion-connector

重启 dsh web 后生效。

使用

  1. 打开 https://www.notion.so/my-integrations 创建内部集成，复制 secret_ 开头的 Internal Integration Secret
  2. 在 Notion 中把要访问的页面/数据库 Share 给该集成
  3. GUI 设置 → Notion 粘贴并保存
  4. 之后对 agent 说「搜索 Notion 里的 XX」「把这段内容存进 Notion」即可

开发

pnpm install        # esbuild / typescript / 类型依赖
pnpm build          # esbuild: lib/index.js (host) + lib/client.js (browser)
pnpm typecheck      # tsc --noEmit
pnpm install:local  # 本地开发快速安装（复制到 ~/.dsh/profiles/node_modules/dsh-notion-connector）

限制

  • 页面/数据库必须分享给该 Integration 才能访问
  • Token 以明文保存在用户主目录私有文件（权限 0600）
  • 插件是第三方代码：安装前请审阅源码，只在信任的来源使用

License

MIT