EVC Team Relay — MCP Server

Give your AI agent read/write access to your Obsidian vault.

Your agent reads your notes, creates new ones, and stays in sync — all through the Team Relay API.

Works with Claude Code, Codex CLI, OpenCode, and any MCP-compatible client.

Quick Start

No installation needed — uvx downloads and runs automatically:

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

Available Tools

Tool	Description
`authenticate`	Authenticate with credentials (auto-managed)
`list_shares`	List accessible shares (filter by kind, ownership)
`list_files`	List files in a folder share
`read_file`	Read a file by path from a folder share
`read_document`	Read document by doc_id
`upsert_file`	Create or update a file by path
`write_document`	Write to a document by doc_id
`delete_file`	Delete a file from a folder share

How It Works

The MCP server wraps Team Relay's REST API into standard MCP tools. Team Relay stores documents as Yjs CRDTs and syncs them to Obsidian clients in real-time. Changes made by the agent appear in Obsidian instantly — and vice versa.

Remote Deployment

Supports HTTP transport for shared or server-side deployments via Docker or direct run.

Prerequisites

Python 3.10+ with uv
A running EVC Team Relay instance
A user account on the Relay control plane

License

MIT

Team Relay