Skip to content

AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.

docs: add Notion migration guide and link it in READMEs

yoma6fed0e883899
diff --git a/README.md b/README.md
index 00842030..d2993fb9 100644
--- a/README.md
+++ b/README.md
@@ -196,6 +196,7 @@ If you want to migrate notes from other platforms to EdgeEver, please refer to t
- **Evernote Migration**: Please refer to [docs/evernote-migration-guide.md](docs/evernote-migration-guide.md)
- **Memos Migration**: Please refer to [docs/memos-migration-guide.md](docs/memos-migration-guide.md)
+- **Notion Migration**: Please refer to [docs/notion-migration-guide.md](docs/notion-migration-guide.md)
## Community and Feedback
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 5b5916ef..23b07ffc 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -202,6 +202,7 @@ Cloudflare Worker 侧执行图片处理会消耗计算/图片处理额度,因
- **印象笔记(Evernote)的迁入**:请参考 [docs/evernote-migration-guide.md](docs/evernote-migration-guide.md)
- **Memos 笔记的迁入**:请参考 [docs/memos-migration-guide.md](docs/memos-migration-guide.md)
+- **Notion 笔记的迁入**:请参考 [docs/notion-migration-guide.md](docs/notion-migration-guide.md)
## 社区与反馈
diff --git a/docs/notion-migration-guide.en-US.md b/docs/notion-migration-guide.en-US.md
new file mode 100644
index 00000000..7c8debad
--- /dev/null
+++ b/docs/notion-migration-guide.en-US.md
@@ -0,0 +1,37 @@
+# Notion Migration Guide
+
+[简体中文](notion-migration-guide.md) | [English](notion-migration-guide.en-US.md)
+
+Thanks to EdgeEver's native support for AI Agent and Model Context Protocol (MCP), if you want to migrate your Notion workspace to EdgeEver, the most elegant way is to use your AI assistant as a bridge. By mounting both the **Notion MCP** and **EdgeEver MCP** servers, you can achieve fully automatic cloud-to-cloud page migration.
+
+---
+
+### Migration Steps
+
+#### Step 1: Install and Enable Both MCP Servers in Your AI Assistant
+
+1. **Configure Notion MCP**:
+ Set up the Notion MCP server in your AI assistant (e.g., Claude Code, Cursor, Cline). Once configured, the AI assistant will be authorized to read your Notion Pages and Databases.
+
+2. **Configure EdgeEver MCP**:
+ - Log in to your EdgeEver instance, and click **Profile** -> **MCP settings**.
+ - Generate an API Token, click **Copy full MCP configuration**, and set it up in your AI assistant.
+
+Make sure your AI assistant can access and call both MCP servers simultaneously.
+
+#### Step 2: Prompt the AI Assistant to Start the Migration
+
+Copy and send the following prompt to the AI assistant that has access to both MCPs:
+
+```text
+You are my AI assistant. You are currently connected to both my Notion MCP server and my new EdgeEver MCP server.
+Please help me migrate my Pages and Databases from Notion to EdgeEver:
+1. Call the Notion MCP tools to read my Notion page content (including titles, body content, creation time, tags, etc.) in batches.
+2. Call the EdgeEver MCP tools to write them into my new EdgeEver instance.
+Please report the total number of successfully imported pages and if any page translation failed.
+```
+
+The AI assistant will automatically parse and convert Notion's Block format and call the EdgeEver write tools to complete the data transfer.
+
+#### Step 3: Verify in Web Browser
+Go back to your EdgeEver web client and refresh the page to confirm that all Notion pages have been successfully recorded, and that their formatting and tags are synchronized.
diff --git a/docs/notion-migration-guide.md b/docs/notion-migration-guide.md
new file mode 100644
index 00000000..fde0533b
--- /dev/null
+++ b/docs/notion-migration-guide.md
@@ -0,0 +1,37 @@
+# Notion 笔记极简迁移指引
+
+[简体中文](notion-migration-guide.md) | [English](notion-migration-guide.en-US.md)
+
+得益于 EdgeEver 对 AI Agent 和 Model Context Protocol (MCP) 的原生支持,如果你想将 Notion 笔记库搬迁到 EdgeEver,最优雅的方式是利用 AI 助手作为数据桥梁,同时挂载 **Notion MCP** 和 **EdgeEver MCP** 服务,实现全自动的云对云笔记导入。
+
+---
+
+### 迁移步骤
+
+#### 步骤 1:在 AI 助手中安装并启用两个 MCP 服务
+
+1. **配置 Notion MCP 服务**:
+ 在你的 AI 助手(如 Claude Code/Cursor/Cline 等)中配置好 Notion MCP 服务。配置成功后,AI 助手将获得直接读取你 Notion 页面(Pages)和数据库(Databases)的授权。
+
+2. **配置 EdgeEver MCP 服务**:
+ - 登录你的 EdgeEver 实例,点击左下角的 **个人中心** -> **MCP 设置**。
+ - 生成 API Token 并点击 **复制完整 MCP 配置**,安装到你的 AI 助手中。
+
+确保你的 AI 助手在运行中能够同时调用这两个 MCP 服务。
+
+#### 步骤 2:对 AI 助手下达迁移指令
+
+复制以下 Prompt 发送给已经挂载好两个 MCP 的 AI 助手:
+
+```text
+你是我的 AI 助手。现在你同时连接了我的 Notion MCP 服务和新 EdgeEver MCP 服务。
+请帮我把旧 Notion 里的笔记和数据库页面迁移到新 EdgeEver 中:
+1. 首先调用 Notion MCP 的读取接口,分批次读出我的 Notion 页面内容(包括标题、正文、创建时间、标签等)。
+2. 然后调用 EdgeEver MCP 的写入接口,将这些读取到的页面批量导入到我的 EdgeEver 实例中。
+请在全量迁移完成后,告诉我总共成功同步导入了多少篇笔记,以及是否有格式转换失败的页面。
+```
+
+AI 助手将自动解析并转换 Notion 的 Block 格式,并调用 EdgeEver 接口完成无痛数据写入。
+
+#### 步骤 3:在网页端验证
+回到 EdgeEver 网页端刷新,确认所有的 Notion 页面已成功转入,笔记内容和排版也都已完美同步。