entire-vc/evc-team-relay-mcp
Free通过 MCP 协议给 AI 代理提供对 Obsidian vault 的读写访问,支持团队协作和多用户共享。
FreeFree tier
About entire-vc/evc-team-relay-mcp
MCP server that gives AI agents read/write access to Obsidian vault documents via EVC Team Relay. Supports team collaboration and multi-user sharing. Works with Claude Code, Codex CLI, OpenCode, and any MCP-compatible client. Provides tools for listing shares, listing files, reading file contents, searching notes (tr_search), and upserting (creating or updating) files. Authentication supports agent keys (recommended) or email/password. Easy installation via uvx or from source.
Key Features
List accessible shares from Team Relay
List files within a share
Read file contents
Search notes using Team Relay search (tr_search)
Upsert (create or update) files in the vault
Authenticate with agent key or email/password (auto-managed)
Team collaboration with multi-user sharing through Team Relay
Compatible with Claude Code, Codex CLI, OpenCode, and any MCP client
Easy installation via uvx or from source (Python)
Pros & Cons
Pros
- Open source (MIT license)
- Easy installation via uvx without manual setup
- Supports both agent key and email/password authentication
- Works with popular AI coding tools like Claude Code and Codex CLI
- Enables team collaboration with multi-user sharing through Team Relay
- Provides rich tools for file operations (list, read, search, upsert)
Cons
- Requires access to a self-hosted EVC Team Relay instance
- Dependent on Obsidian and the Team Relay plugin
- No built-in UI; requires command-line configuration
- Only supports Obsidian vaults connected to Team Relay
Best For
AI agent reading and summarizing notes from an Obsidian vaultAI assistant creating new notes based on conversation contextTeam collaboration with shared Obsidian vaults through Team RelaySearching and retrieving relevant notes for AI contextIntegrating Obsidian knowledge into AI coding workflows
FAQ
What AI tools are compatible?
Claude Code, Codex CLI, OpenCode, and any MCP-compatible client.
How do I install the server?
Recommended: use uvx which downloads and runs automatically. Alternatively, install from source via git clone and uv sync or pip install.
What authentication methods are available?
Agent key (recommended) — create a key in the Obsidian plugin's Team Relay settings for read and write. Also supports email + password for a dedicated agent account.