evc-team-relay-mcp 1.0.0

MCP server for reading and writing Obsidian vault documents via EVC Team Relay

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

1. Clone and install

git clone https://github.com/entire-vc/evc-team-relay-mcp.git
cd evc-team-relay-mcp
uv sync   # or: pip install .

2. Configure your AI tool

Copy the config snippet for your tool. Replace /path/to/ with the actual clone path and fill in your credentials.

Claude Code

Add to .mcp.json in your project root or ~/.claude/.mcp.json:

{
  "mcpServers": {
    "evc-relay": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/evc-team-relay-mcp", "relay_mcp.py"],
      "env": {
        "RELAY_CP_URL": "https://cp.yourdomain.com",
        "RELAY_EMAIL": "[e-mail]",
        "RELAY_PASSWORD": "your-password"
      }
    }
  }
}

Codex CLI

Add to your codex.json:

{
  "mcp_servers": {
    "evc-relay": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "--directory", "/path/to/evc-team-relay-mcp", "relay_mcp.py"],
      "env": {
        "RELAY_CP_URL": "https://cp.yourdomain.com",
        "RELAY_EMAIL": "[e-mail]",
        "RELAY_PASSWORD": "your-password"
      }
    }
  }
}

OpenCode

Add to opencode.json:

{
  "mcpServers": {
    "evc-relay": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/evc-team-relay-mcp", "relay_mcp.py"],
      "env": {
        "RELAY_CP_URL": "https://cp.yourdomain.com",
        "RELAY_EMAIL": "[e-mail]",
        "RELAY_PASSWORD": "your-password"
      }
    }
  }
}

Ready-to-copy config templates are in config/.

3. Use it

Your AI agent now has these 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 (low-level)
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

Typical workflow: list_shares -> list_files -> read_file / upsert_file

Authentication is automatic — the server logs in and refreshes tokens internally.

---

Remote Deployment (HTTP Transport)

For shared or server-side deployments, run as an HTTP server:

# Direct
uv run relay_mcp.py --transport http --port 8888

# Docker
RELAY_CP_URL=https://cp.yourdomain.com \
RELAY_EMAIL=[e-mail] \
RELAY_PASSWORD=your-password \
docker compose up -d

Then configure your MCP client to connect via HTTP:

{
  "mcpServers": {
    "evc-relay": {
      "type": "streamable-http",
      "url": "http://your-server:8888/mcp"
    }
  }
}

---

How It Works

┌─────────────┐      MCP        ┌──────────────┐     REST API     ┌──────────────┐     Yjs CRDT      ┌──────────────┐
│  AI Agent   │ ◄────────────► │  MCP Server  │ ◄─────────────► │  Team Relay  │ ◄──────────────► │   Obsidian   │
│ (any tool)  │  stdio / HTTP  │ (this repo)  │    read/write   │   Server     │    real-time     │    Client    │
└─────────────┘                └──────────────┘                 └──────────────┘      sync         └──────────────┘

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.

---

Prerequisites

• Python 3.10+ with uv (recommended) or pip
• A running EVC Team Relay instance (self-hosted or hosted)
• A user account on the Relay control plane

---

Part of the Entire VC Toolbox

Product	What it does	Link
Team Relay	Self-hosted collaboration server	repo
Team Relay Plugin	Obsidian plugin for Team Relay	repo
Relay MCP	MCP server for AI agents	this repo
OpenClaw Skill	OpenClaw agent skill (bash)	repo
Local Sync	Vault <-> AI dev tools sync	repo
Spark MCP	MCP server for AI workflow catalog	repo

Community

• entire.vc
• Discussions
• [e-mail]

License

MIT