Upnote Lens Mcp

MCP办公协作

提供方 AwesomeHye · 包名 upnote-lens-mcp

办公协作 stdio · 本地进程 会话登录 社区 / 第三方 Claude DesktopClaudeCursorCodex
查看接入方式

Let AI read, search, and summarize your UpNote notes — and create new ones — right from your chat.

一句话选型结论

按资料字段整理

Upnote Lens Mcp 属于办公协作类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Claude Desktop、Claude、Cursor 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 未标注 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

notes sqlite note taking productivity second brain

支持客户端

适用场景

notessqlitenote taking

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
uvx upnote-lens-mcp

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Cross-platform,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Upnote Lens Mcp当前 未标注 stdio · 本地进程 本地部署 有 未标注
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方AwesomeHye上游标注的维护方 AwesomeHye
分类办公协作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时upnote-lens-mcp · Cross-platform本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验未标注上游最后核验时间

详细介绍

5.0 KB
来自项目仓库与上游目录的原文,未做删改

upnote-lens-mcp

A hybrid MCP server that lets your AI assistant work with your UpNote notes:

  • 🔍 Find & search notes by keyword across titles and bodies.
  • 📖 Read & summarize — it returns the actual note text, so the AI can
    summarize, analyze, or answer questions about what you've written.
  • ✍️ Create new notes from the chat.

Under the hood: reads come from the local UpNote SQLite database (read-only),
so real content comes back as text; writes go through the upnote:// URL scheme
(x-callback-url) and never touch the database.

> The write side (URL scheme) is based on chadthornton/upnote-mcp (MIT).

Usage

Once it's registered, just talk to your AI assistant in plain language — it
picks the right tool for you. No commands or syntax to memorize. For example:

  • "Summarize my UpNote notes about the Q3 roadmap."
  • "Find notes where I mentioned Postgres tuning and pull out the key points."
  • "What did I write about onboarding last month?"
  • "Show me my 5 most recent notes."
  • "Create a note titled 'Standup 6/4' with today's three priorities."

Reading, searching, summarizing, and creating all happen through natural
conversation.

Requirements

  • macOS — fully supported and verified.
  • Windows — best-effort. URLs launch through the registered scheme handler,
    and the default DB path is guessed under %APPDATA%\UpNote\. This path is
    not verified by the author — if reads fail, set UPNOTE_LENS_DB (see below).
  • Python 3.10+ (or just uv, which brings its own).
  • UpNote desktop app installed.

Install & register

🤖 Let AI install it (easiest)

Give your MCP client (Claude, etc.) a link to
llms-install.md and it will run the steps and set everything
up for you.

🧑 Install it yourself

Pick the first option that fits what you already have. Each option includes how
to register it in Claude.

> Claude Desktop config file (referenced in each option):
> - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
> - Windows: %APPDATA%\Claude\claude_desktop_config.json

Option 1 — with uv (recommended)

Requires uv installed once
(brew install uv, or curl -LsSf https://astral.sh/uv/install.sh | sh).
After that there's no package install step — uvx downloads, caches, and
runs upnote-lens-mcp on demand.

Claude Code:```bash
claude mcp add upnote-lens -- uvx upnote-lens-mcp

Claude Desktop:```json
{ "mcpServers": { "upnote-lens": { "command": "uvx", "args": ["upnote-lens-mcp"] } } }

Option 2 — with pip (if you don't have uv)```bash

pip install upnote-lens-mcp


Claude Code:```bash
claude mcp add upnote-lens -- upnote-lens-mcp

Claude Desktop:```json
{ "mcpServers": { "upnote-lens": { "command": "upnote-lens-mcp" } } }


#### Option 3 — from GitHub over HTTPS (if you don't have pip)

When you can't use PyPI/pip, install straight from the repo with uv. (No uv yet?
`curl -LsSf https://astral.sh/uv/install.sh | sh`.)

Claude Code:```bash
claude mcp add upnote-lens -- uvx --from git+https://github.com/AwesomeHye/upnote-lens-mcp upnote-lens-mcp

Claude Desktop:```json
{ "mcpServers": { "upnote-lens": { "command": "uvx", "args": ["--from", "git+https://github.com/AwesomeHye/upnote-lens-mcp", "upnote-lens-mcp"] } } }


## Tools

### Read (queries the local DB → returns real text)

| Tool | Description |
|---|---|
| `search_notes(query, limit=20)` | Substring search over title/body. Returns id, title, updated time, snippet |
| `get_note(note_id, include_html=False)` | Full title + body text of a note (optionally raw HTML) |
| `list_recent(limit=20)` | Most recently updated notes |
| `list_notebooks()` | Notebooks with note counts and parent |
| `list_notes_in_notebook(notebook_id, limit=50)` | Notes inside a notebook |
| `list_tags()` | Tags with note counts |
| `list_notes_by_tag(tag_title, limit=50)` | Notes carrying a tag |

### Write (`upnote://` URL scheme)

| Tool | Description |
|---|---|
| `create_note(title, content, notebook?, markdown=True, new_window=False)` | Create a note. `content` is Markdown by default. `notebook` matches by name. **Tags can't be set** (see below) |
| `open_note(note_id, new_window=False)` | Open an existing note in the app |
| `open_notebook(notebook_id)` | Open a notebook in the app |

> **Tag limitation**: UpNote's `note/new` URL scheme has no tag parameter, and
> hashtags placed in the body stay as plain text rather than becoming real tags
> (they only convert to tags when typed in the editor). If you need tags, add
> them manually in the app after the note is created.

## Override the DB path

If the database isn't in the default location (or you're on Windows), point at it
with an environment variable:```
UPNOTE_LENS_DB=/path/to/upnote.sqlite3

Default paths:
- macOS: ~/Library/Containers/com.getupnote.desktop/Data/Library/Application Support/UpNote/upnote.sqlite3
- Windows (best guess): %APPDATA%\UpNote\upnote.sqlite3

License

MIT. See LICENSE for details.
The URL-scheme formats and launch approach on the write side are adapted from
chadthornton/upnote-mcp (MIT).

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Upnote Lens Mcp 怎么安装?

在客户端按下面的安装命令接入:uvx upnote-lens-mcp。对应的包名是 upnote-lens-mcp。装完在客户端配置里引用同一个包或端点。

Upnote Lens Mcp 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Upnote Lens Mcp 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Upnote Lens Mcp 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Upnote Lens Mcp 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor、Codex、Zed;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Upnote Lens Mcp 能提供哪些能力?

资料显示能力标签包括 notes、sqlite、note taking、productivity、second brain。具体工具清单以官方文档为准。

Upnote Lens Mcp 需要什么运行环境?

运行时为 Cross-platform;属于本地进程,需要在本机装好运行环境。

Upnote Lens Mcp 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 未标注。