Obsidian Search
AI-powered semantic search for your Obsidian notes — find notes by meaning, not just keywords. Powered by Obvec.
Security & Data Handling
- - MCP link is a credential: Your MCP Server URL (
https://rag.10xboost.org/mcp?token=xxxxx) contains an embedded authentication token. Treat it like a password — do not share it publicly. - Token scope: The token grants read-only access. It can search, list, retrieve note content, and analyze connections. It cannot modify, delete, or create notes in your Obsidian vault.
- Token lifetime: Tokens are valid for 30 days. After expiry, you will need to get a new MCP link from obsidian.10xboost.org. You can also regenerate the token at any time in Settings, which invalidates any previously shared links.
- Where the token is stored: The token is generated server-side by Obvec. When you paste the MCP link into a Claude Connector or MCP client config, that client stores the link locally on your device. Revoking or regenerating the token server-side invalidates all copies.
- Your note data: To provide semantic search, your Obsidian note content is uploaded to the Obvec server and stored as text and vector embeddings. This means your note content is stored on a third-party server (Obvec, hosted on Google Cloud). Notes are isolated per user and are not shared with other users or used for model training. You can delete your indexed data at any time from your account dashboard.
- No additional credentials: No separate API keys, environment variables, or secrets are needed beyond the MCP link.
Prerequisites
- 1. Sign up at obsidian.10xboost.org with Google
- Connect your Obsidian vault — follow the setup guide to sync your notes
- Get your MCP link: Go to Settings → copy your MCP Server URL
- Add to Claude: Paste the MCP link as a Connector — no install, no API key needed
Available Tools (4)
| Tool | Description |
|---|
| INLINECODE1 | Semantic search — find notes by meaning with similarity scoring, tag/date filters |
| INLINECODE2 |
Browse notes by folder, tags, date range, with sorting options |
|
get_note | Retrieve full content of a specific note by path or search term |
|
analyze_connections | Discover related notes through AI-powered similarity analysis |
Workflow
Step 1: Understand the User's Intent
| User Request | Tool to Use |
|---|
| "Find notes about X" | INLINECODE5 |
| "What did I write about X?" |
search_notes |
| "Show my recent notes" |
list_notes with
sortBy: "modifiedAt" |
| "Notes in folder X" |
list_notes with
pathPrefix |
| "Open note X" |
get_note |
| "What's related to X?" |
analyze_connections |
Step 2: Search Notes
Semantic Search
CODEBLOCK0
With Filters
CODEBLOCK1
Step 3: Retrieve Full Content
CODEBLOCK2
or search by term:
CODEBLOCK3
Step 4: Discover Connections
CODEBLOCK4
Returns notes most semantically similar to the reference — great for finding related ideas, building knowledge graphs, or discovering forgotten notes.
Step 5: Present Results
- - Search results: Show titles, relevance scores, and brief excerpts
- Note content: Display the full markdown content
- Connections: Present as a ranked list with similarity scores and note titles
Error Handling
| Error | Solution |
|---|
| No results found | Try a broader query or lower INLINECODE13 |
| Note not found |
Use
list_notes to find the correct path |
| Token expired | Get a new MCP link from
obsidian.10xboost.org Settings (tokens last 30 days) |
Obsidian Search
基于AI的语义搜索,适用于你的Obsidian笔记——通过含义而非仅关键词查找笔记。由Obvec提供支持。
安全与数据处理
- - MCP链接即凭证:你的MCP服务器URL(https://rag.10xboost.org/mcp?token=xxxxx)包含一个嵌入的身份验证令牌。请像对待密码一样对待它——不要公开分享。
- 令牌范围:该令牌授予只读权限。它可以搜索、列出、检索笔记内容以及分析关联。它无法修改、删除或创建你Obsidian库中的笔记。
- 令牌有效期:令牌有效期为30天。过期后,你需要从obsidian.10xboost.org获取新的MCP链接。你也可以随时在设置中重新生成令牌,这将使之前分享的所有链接失效。
- 令牌存储位置:令牌由Obvec在服务器端生成。当你将MCP链接粘贴到Claude连接器或MCP客户端配置中时,该客户端会将链接本地存储在你的设备上。在服务器端撤销或重新生成令牌将使所有副本失效。
- 你的笔记数据:为了提供语义搜索,你的Obsidian笔记内容会上传到Obvec服务器,并以文本和向量嵌入的形式存储。这意味着你的笔记内容存储在第三方服务器上(Obvec,托管于Google Cloud)。笔记按用户隔离,不会与其他用户共享或用于模型训练。你可以随时从你的账户仪表板删除已索引的数据。
- 无需额外凭证:除了MCP链接外,无需单独的API密钥、环境变量或密钥。
前提条件
- 1. 注册:使用Google账号在obsidian.10xboost.org注册
- 连接你的Obsidian库——按照设置指南同步你的笔记
- 获取你的MCP链接:前往设置→复制你的MCP服务器URL
- 添加到Claude:将MCP链接粘贴为连接器——无需安装,无需API密钥
可用工具(4个)
| 工具 | 描述 |
|---|
| searchnotes | 语义搜索——通过含义查找笔记,支持相似度评分、标签/日期筛选 |
| listnotes |
按文件夹、标签、日期范围浏览笔记,支持排序选项 |
| get_note | 按路径或搜索词检索特定笔记的完整内容 |
| analyze_connections | 通过AI驱动的相似度分析发现相关笔记 |
工作流程
步骤1:理解用户意图
| 用户请求 | 使用的工具 |
|---|
| 查找关于X的笔记 | searchnotes |
| 我写过关于X的什么内容? |
searchnotes |
| 显示我最近的笔记 | list_notes,使用sortBy: modifiedAt |
| 文件夹X中的笔记 | list_notes,使用pathPrefix |
| 打开笔记X | get_note |
| 什么与X相关? | analyze_connections |
步骤2:搜索笔记
语义搜索
search_notes(
query: 机器学习项目创意,
limit: 10,
minScore: 0.7
)
带筛选条件
search_notes(
query: 会议记录,
tags: [工作, 项目-X],
sortBy: modifiedAt,
limit: 20
)
步骤3:检索完整内容
get_note(path: 项目/AI研究.md)
或按搜索词检索:
get_note(searchTerm: 季度回顾)
步骤4:发现关联
analyze_connections(
reference: 项目/AI研究.md,
limit: 10,
minScore: 0.6
)
返回与参考笔记语义最相似的笔记——非常适合寻找相关想法、构建知识图谱或发现被遗忘的笔记。
步骤5:呈现结果
- - 搜索结果:显示标题、相关度分数和简短摘录
- 笔记内容:显示完整的Markdown内容
- 关联:以排名列表形式呈现,包含相似度分数和笔记标题
错误处理
| 错误 | 解决方案 |
|---|
| 未找到结果 | 尝试更宽泛的查询或降低minScore |
| 未找到笔记 |
使用list_notes查找正确的路径 |
| 令牌过期 | 从
obsidian.10xboost.org设置中获取新的MCP链接(令牌有效期为30天) |