内容
# 🗒️ Google Keep MCP 服务器
> 直接连接任意 AI 助手到您的 Google Keep — 创建、搜索、组织、导出笔记、设置提醒事项等。
[](https://pypi.org/project/google-keep-notes-mcp/)
[](https://www.python.org/)
[](LICENSE)
[](https://modelcontextprotocol.io/)
---
## ✨ 功能特点
| | 功能 | 描述 |
|--|---------|-------------|
| 📝 | **笔记** | 创建、读取、更新、删除、归档笔记 |
| 🔍 | **搜索** | 按关键词即时查找笔记 |
| 📌 | **组织** | 置顶笔记、更改颜色、添加标签 |
| 🏷️ | **标签** | 创建、应用、移除标签 — 带有自动标签功能 |
| ⏰ | **提醒事项** | 通过 Google Tasks 集成设置提醒事项 |
| 👥 | **协作** | 通过电子邮件添加或移除协作者 |
| 📤 | **导出** | 将任意笔记导出为 PDF、Word（DOCX）或 Markdown |
| 📊 | **分析** | 获取统计数据 — 总笔记数、标签数、最旧/最新笔记 |
| 📅 | **摘要** | 置顶和最近笔记的每日/每周摘要 |
| 📋 | **模板** | 预建模板：会议、日志、项目、购物、想法 |
---
## 📦 安装
```bash
pip install google-keep-notes-mcp
```
```bash
uv add google-keep-notes-mcp
```
或直接运行而无需安装（推荐用于 MCP 客户端）：
```bash
uvx google-keep-notes-mcp
```
需要 Python 3.10+
---
## 🔐 身份验证
此软件包使用从您的 Google 账户会话中获取的**主令牌**。这是一次性设置。
> ⚠️ 为安全起见，请使用**专用/虚拟 Google 账户**。
### 首次设置
**步骤 1 — 运行设置命令：**
```bash
google-keep-mcp setup
```
这将自动在您的浏览器中打开 `accounts.google.com/EmbeddedSetup` 并逐步引导您。
**步骤 2 — 在浏览器中：**
1. 使用您的 Google 账户登录
2. 点击 **"我同意"**
3. 按 `F12` 打开开发者工具
4. 进入 **应用程序 → Cookie → accounts.google.com**
5. 找到 `oauth_token` 行 → 点击它
6. 在底部，**三击** Cookie 值 → `Ctrl+C` 复制
> ⚡ 这样做要快 — 令牌很快就会过期。在复制之前请准备好您的终端。
**步骤 3 — 返回终端：**
粘贴您的电子邮件和复制的 `oauth_token` 值，当提示时。您的主令牌将自动生成并保存到：
```
~/.google_keep_mcp/config.env
```
除非您的令牌过期，否则您无需再次执行此操作。
---
## ⏰ 提醒事项设置（可选）
提醒事项使用 **Google Tasks API**。需要一次性设置：
1. 进入 [console.cloud.google.com](https://console.cloud.google.com) → 创建新项目
2. 启用 **Google Tasks API**
3. 进入 **OAuth 同意屏幕** → 将您的 Google 账户添加为测试用户
4. 创建 **OAuth 2.0 凭证** → 桌面应用程序类型 → 下载 `credentials.json`
5. 将其放在：`~/.google_keep_mcp/credentials.json`
首次设置提醒事项时，将打开一个浏览器窗口进行授权。之后，它将完全自动。
---
## 🖥️ 客户端设置
<details>
<summary><b>Claude 桌面版</b></summary>
编辑您的 `claude_desktop_config.json`:
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"google-keep": {
"command": "uvx",
"args": ["google-keep-notes-mcp"]
}
}
}
```
</details>
<details>
<summary><b>Cursor</b></summary>
打开 **Cursor 设置** → **MCP** → **添加新服务器** → 粘贴：
```json
{
"mcpServers": {
"google-keep": {
"command": "uvx",
"args": ["google-keep-notes-mcp"]
}
}
}
```
</details>
<details>
<summary><b>VS Code — GitHub Copilot</b></summary>
创建或编辑：
- **Windows:** `%APPDATA%\Code\User\mcp.json`
- **macOS/Linux:** `~/.config/Code/User/mcp.json`
```json
{
"servers": {
"google-keep": {
"type": "stdio",
"command": "uvx",
"args": ["google-keep-notes-mcp"]
}
}
}
```
</details>
<details>
<summary><b>Windsurf</b></summary>
打开 **Windsurf 设置** → **MCP** → **添加服务器**:
```json
{
"mcpServers": {
"google-keep": {
"command": "uvx",
"args": ["google-keep-notes-mcp"]
}
}
}
```
</details>
---
## 🛠️ 工具参考
### 笔记
| 工具 | 描述 |
|------|-------------|
| `keep_create_note` | 创建带有标题和内容的笔记 |
| `keep_list_notes` | 列出所有活动笔记 |
| `keep_get_note` | 按 ID 获取特定笔记 |
| `keep_update_note` | 更新笔记的标题或内容 |
| `keep_delete_note` | 删除（放入回收站）笔记 |
| `keep_archive_note` | 归档笔记 |
| `keep_search_notes` | 按关键词搜索笔记 |
### 组织
| 工具 | 描述 |
|------|-------------|
| `keep_pin_note` | 置顶或取消置顶笔记 |
| `keep_change_color` | 更改笔记颜色（红色、蓝色、绿色、黄色、青色、粉色、紫色、灰色、棕色、白色） |
### 标签
| 工具 | 描述 |
|------|-------------|
| `keep_create_label` | 创建新标签 |
| `keep_add_label` | 将标签添加到笔记 |
| `keep_remove_label` | 从笔记中移除标签 |
| `keep_list_labels` | 列出所有标签 |
| `keep_auto_label_note` | 自动检测并将标签应用于单个笔记 |
| `keep_auto_label_all` | 自动为所有未标记的笔记添加标签 |
### 提醒事项和协作
| 工具 | 描述 |
|------|-------------|
| `keep_set_reminder` | 通过 Google Tasks 设置提醒事项（`YYYY-MM-DD HH:MM`） |
| `keep_add_collaborator` | 通过电子邮件添加协作者 |
| `keep_remove_collaborator` | 通过电子邮件移除协作者 |
### 导出
| 工具 | 描述 |
|------|-------------|
| `keep_export_note` | 将笔记导出为 PDF、DOCX 或 Markdown — 保存到 `~/Desktop/KeepExports/` |
### 分析
| 工具 | 描述 |
|------|-------------|
| `keep_get_analytics` | 完整统计数据 — 总笔记数、标签使用情况、最旧/最新笔记、颜色 |
| `keep_get_weekly_digest` | 智能摘要 — 置顶、最近更新的笔记，按标签分类 |
### 模板
| 工具 | 描述 |
|------|-------------|
| `keep_list_templates` | 列出所有可用模板 |
| `keep_create_from_template` | 从预建模板创建笔记 |
**可用模板：** `meeting` · `journal` · `project` · `shopping` · `ideas`
---
## 💬 示例提示
```
创建标题为 "周末计划" 的笔记，包含待办事项列表
```
```
搜索我的笔记中关于 Python 的内容
```
```
为 "实习申请" 笔记设置明天 9 点的提醒事项
```
```
将 "MCP 概念" 笔记导出为 PDF
```
```
自动为所有笔记添加标签
```
```
给我一个 Google Keep 笔记的每周摘要
```
```
显示我的笔记分析数据
```
```
从今天的站会模板创建会议笔记
```
```
将协作者 friend@gmail.com 添加到 "项目计划" 笔记中
```
---
## ❌ 已知限制
- **图片附件** — 无法在笔记中附加图片（Google 的私有上传端点在此库中不可用）
- **原生提醒事项铃声** — 无法通过此方法设置 Keep 的内置提醒事项铃声；提醒事项改用 Google Tasks 创建（与通知功能完全集成）
---
## 📄 许可证
MIT © Muhammad Abubakar
