Connect Obsidian to AI Agents

Team Relay MCP Server wraps EVC Team Relay's REST API into standard MCP tools, giving an AI agent read and write access to a shared Obsidian vault. The agent lists accessible shares, reads and writes files or documents, and creates or deletes files - all synced live to Obsidian, since Team Relay stores documents as Yjs CRDTs and pushes changes to connected Obsidian clients instantly, in both directions.

Use this when you want Claude Code, Codex CLI, OpenCode, or any MCP-compatible client to read or update the same Obsidian notes your team works in directly - pulling specs, updating docs alongside code changes, or handing work between agent and human through a shared folder. It's built for teams that already treat Obsidian as shared team knowledge. It is not useful without an existing EVC Team Relay deployment and a user account on its control plane, and it only reaches shares you have access to - it's not a general-purpose file system connector.

• authenticate: logs in with credentials (auto-managed internally, including JWT refresh).
• list_shares: lists accessible shares, filterable by kind and ownership.
• list_files: lists files in a folder share.
• read_file: reads a file by path from a folder share.
• read_document: reads a document by its low-level doc_id.
• upsert_file: creates or updates a file by path.
• write_document: writes to a document by doc_id.
• delete_file: deletes a file from a folder share.

Typical workflow: list_shares -> list_files -> read_file / upsert_file. All operations are Python function calls via JSON-RPC (no shell execution, no credentials passed as CLI arguments), with typed inputs validated against JSON Schema and a single persistent process rather than per-call spawning.

No installation needed - uvx downloads and runs it automatically. For Claude Code, add to .mcp.json:

{
  "mcpServers": {
    "evc-relay": {
      "command": "uvx",
      "args": ["evc-team-relay-mcp"],
      "env": {
        "RELAY_CP_URL": "https://cp.tr.entire.vc",
        "RELAY_EMAIL": "agent@yourdomain.com",
        "RELAY_PASSWORD": "your-password"
      }
    }
  }
}

Similar configs work for Codex CLI (codex.json) and OpenCode (opencode.json). For shared or server-side use, run via HTTP transport with docker compose up -d and connect using "type": "streamable-http" pointed at the server URL. Requires Python 3.10+ with uv, and an account on the Relay control plane.

Teams running Claude Code, Codex CLI, OpenCode, or other MCP clients who want their AI agent reading and writing the same shared Obsidian vault the team uses, staying in sync instantly rather than working from a stale copy.