MinerU
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
MCP server for AI agent read/write access to Obsidian vaults via EVC Team Relay.
Skills that teach the AI this kind of work; they work alongside this one
Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.
A privacy-first app that strips AI watermarks from content you own.
Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 7/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 19/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Evc Team Relay MCP. Follow https://mcp.popnx.com/i/entire-vc-evc-team-relay-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a Evc Team Relay MCP key (create it on the maker’s site) · 1 setting(s) to fill in (RELAY_CP_URL) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Evc Team Relay MCP for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "evc-team-relay": { "command": "uvx", "args": [ "evc-team-relay-mcp" ], "env": { "RELAY_CP_URL": "your-value", "RELAY_AGENT_KEY": "your-value", "RELAY_AGENT_KEYS": "your-value", "RELAY_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For RELAY_AGENT_KEY, RELAY_AGENT_KEYS, RELAY_PASSWORD, RELAY_CP_URL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Evc Team Relay MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
RELAY_CP_URL URL of the Team Relay control plane (e.g. https://cp.yourdomain.com)Descriptions are as written by the maker.
SettingsDeveloperEdit Config
{
"mcpServers": {
"evc-team-relay": {
"command": "uvx",
"args": [
"evc-team-relay-mcp"
],
"env": {
"RELAY_CP_URL": "your-value",
"RELAY_AGENT_KEY": "your-value",
"RELAY_AGENT_KEYS": "your-value",
"RELAY_PASSWORD": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use Evc Team Relay MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using Evc Team Relay MCP or shows a Evc Team Relay MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
RELAY_EMAIL Email for password auth (fallback when no agent key is configured)Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Evc Team Relay MCP yet
Evc Team Relay MCP runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Evc Team Relay MCP
Works with Claude Code, with some setup first
You need a Evc Team Relay MCP key (create it on the maker’s site) · 1 setting(s) to fill in (RELAY_CP_URL) · Install Python (uv) on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Evc Team Relay MCP for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user evc-team-relay --env RELAY_CP_URL=your-value --env RELAY_AGENT_KEY=your-value --env RELAY_AGENT_KEYS=your-value --env RELAY_PASSWORD=your-value -- uvx evc-team-relay-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For RELAY_AGENT_KEY, RELAY_AGENT_KEYS, RELAY_PASSWORD, RELAY_CP_URL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Evc Team Relay MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
RELAY_CP_URL URL of the Team Relay control plane (e.g. https://cp.yourdomain.com)Descriptions are as written by the maker.
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user evc-team-relay --env RELAY_CP_URL=your-value --env RELAY_AGENT_KEY=your-value --env RELAY_AGENT_KEYS=your-value --env RELAY_PASSWORD=your-value -- uvx evc-team-relay-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see Evc Team Relay MCP listed as connected
Use Evc Team Relay MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Evc Team Relay MCP or shows a Evc Team Relay MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
RELAY_EMAIL Email for password auth (fallback when no agent key is configured)Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a Evc Team Relay MCP key (create it on the maker’s site) · 1 setting(s) to fill in (RELAY_CP_URL) · Install Python (uv) on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Evc Team Relay MCP for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "evc-team-relay": { "command": "uvx", "args": [ "evc-team-relay-mcp" ], "env": { "RELAY_CP_URL": "your-value", "RELAY_AGENT_KEY": "your-value", "RELAY_AGENT_KEYS": "your-value", "RELAY_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For RELAY_AGENT_KEY, RELAY_AGENT_KEYS, RELAY_PASSWORD, RELAY_CP_URL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Evc Team Relay MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
RELAY_CP_URL URL of the Team Relay control plane (e.g. https://cp.yourdomain.com)Descriptions are as written by the maker.
In the Evc Team Relay MCP settings, RELAY_AGENT_KEY, RELAY_AGENT_KEYS, RELAY_PASSWORD, RELAY_CP_URL is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Evc Team Relay MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Evc Team Relay MCP or shows a Evc Team Relay MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
RELAY_EMAIL Email for password auth (fallback when no agent key is configured)Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a Evc Team Relay MCP key (create it on the maker’s site) · 1 setting(s) to fill in (RELAY_CP_URL) · Install Python (uv) on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Evc Team Relay MCP for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "evc-team-relay": { "type": "stdio", "command": "uvx", "args": [ "evc-team-relay-mcp" ], "env": { "RELAY_CP_URL": "your-value", "RELAY_AGENT_KEY": "your-value", "RELAY_AGENT_KEYS": "your-value", "RELAY_PASSWORD": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For RELAY_AGENT_KEY, RELAY_AGENT_KEYS, RELAY_PASSWORD, RELAY_CP_URL, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Evc Team Relay MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
These are program settings, not keys. No sign-up needed; fill them in as the maker describes.
RELAY_CP_URL URL of the Team Relay control plane (e.g. https://cp.yourdomain.com)Descriptions are as written by the maker.
In the Evc Team Relay MCP settings, RELAY_AGENT_KEY, RELAY_AGENT_KEYS, RELAY_PASSWORD, RELAY_CP_URL is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Evc Team Relay MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Evc Team Relay MCP or shows a Evc Team Relay MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
RELAY_EMAIL Email for password auth (fallback when no agent key is configured)Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user evc-team-relay --env RELAY_CP_URL=your-value --env RELAY_AGENT_KEY=your-value --env RELAY_AGENT_KEYS=your-value --env RELAY_PASSWORD=your-value -- uvx evc-team-relay-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"evc-team-relay": {
"command": "uvx",
"args": [
"evc-team-relay-mcp"
],
"env": {
"RELAY_CP_URL": "your-value",
"RELAY_AGENT_KEY": "your-value",
"RELAY_AGENT_KEYS": "your-value",
"RELAY_PASSWORD": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"evc-team-relay": {
"command": "uvx",
"args": [
"evc-team-relay-mcp"
],
"env": {
"RELAY_CP_URL": "your-value",
"RELAY_AGENT_KEY": "your-value",
"RELAY_AGENT_KEYS": "your-value",
"RELAY_PASSWORD": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"evc-team-relay": {
"type": "stdio",
"command": "uvx",
"args": [
"evc-team-relay-mcp"
],
"env": {
"RELAY_CP_URL": "your-value",
"RELAY_AGENT_KEY": "your-value",
"RELAY_AGENT_KEYS": "your-value",
"RELAY_PASSWORD": "your-value"
}
}
}
}RELAY_CP_URL required envRELAY_AGENT_KEY secret required envRELAY_AGENT_KEYS secret required envRELAY_EMAIL envRELAY_PASSWORD secret required envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The registry name was verified with the GitHub account entire-vc, which owns the repo
Code last changed 18 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for evc-team-relay-mcp@1.0.10
Checks only this package version, not every dependency · checked Nov 15, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/entire-vc-evc-team-relay-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: RELAY_AGENT_KEY, RELAY_AGENT_KEYS, RELAY_PASSWORD
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 18 days ago, and the latest version (1.0.10) reached the registry 18 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.
In the same category: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more
XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.
Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Atlassian’s official server lets AI search and manage Jira work and Confluence pages. Connects to Atlassian’s cloud with OAuth sign-in.
MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.
| This one Evc Team Relay MCP | Puter MCP | XcodeBuildMCP | Vexa | Atlassian Rovo MCP Server | Anki MCP Server | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Installs on your computer |
| Needs a key | Yes | No | No | Yes | No | No |
| Add with + in Claude | No | No | No | No | Yes | No |
| Basic checks | 3/3 | 4/4 | 3/3 | 2/4 | 4/4 | 3/3 |
| License | MIT | AGPL-3.0 | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
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.
Option A — from PyPI (recommended):
No installation needed — uvx downloads and runs automatically. Skip to step 2.
Option B — from source:
git clone https://github.com/entire-vc/evc-team-relay-mcp.git
cd evc-team-relay-mcp uv sync # or: pip install .
Add the MCP server to your tool's config. Choose one authentication method:
Agent key (recommended) — create a key in the Obsidian plugin → Team Relay settings → Agent Keys. Supports read and write: list_files, read_file, tr_search, and upsert_file all work with a single key. Quickstart →
Email + password — use a dedicated agent account on your Relay instance.
Claude Code — agent key
Add to .mcp.json in your project root or ~/.claude/.mcp.json:
{
"mcpServers": { "evc-relay": { "command": "uvx", "args": ["evc-team-relay-mcp"], "env": { "RELAY_CP_URL": "https://cp.yourdomain.com", "RELAY_AGENT_KEY": "tr_agent_your_key_here" } } } }
Claude Code — email/password
{
"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" } } } }
Codex CLI
Add to your codex.json:
{
"mcp_servers": { "evc-relay": { "type": "stdio", "command": "uvx", "args": ["evc-team-relay-mcp"], "env": { "RELAY_CP_URL": "https://cp.yourdomain.com", "RELAY_AGENT_KEY": "tr_agent_your_key_here" } } } }
OpenCode
Add to opencode.json:
{
"mcpServers": { "evc-relay": { "command": "uvx", "args": ["evc-team-relay-mcp"], "env": { "RELAY_CP_URL": "https://cp.yourdomain.com", "RELAY_AGENT_KEY": "tr_agent_your_key_here" } } } }
From source (all tools)
If you installed from source instead of PyPI, replace "command": "uvx" / "args": ["evc-team-relay-mcp"] with:
"command": "uv",
"args": ["run", "--directory", "/path/to/evc-team-relay-mcp", "relay_mcp.py"]
Environment variables:
| Variable | Required | Description |
|---|---|---|
RELAY_CP_URL | Yes | Control plane base URL |
RELAY_AGENT_KEY | One of | Agent key from plugin settings — read + write (recommended) |
RELAY_EMAIL | One of | Account email (email/password mode) |
RELAY_PASSWORD | One of | Account password (email/password mode) |
Ready-to-copy config templates are also in config/.
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 | Not implemented — no backend route in any auth mode, always raises |
| `upsert_file` | Create or update a file by path — agent-key mode only; raises in email/password (JWT) mode |
write_document | Not implemented — no backend route in any auth mode, always raises |
delete_file | Not implemented — no backend route in any auth mode, always raises |
Typical workflow: list_shares -> list_files -> read_file / upsert_file
Authentication is automatic — the server logs in and refreshes tokens internally.
Not every tool works in every auth mode, and one group doesn't work in *either* mode — these are two unrelated facts, so don't conflate them:
| Group | Tools | Status |
|---|---|---|
| Agent key, folder shares | list_files, read_file, upsert_file | Working — the only write path in this MCP server |
| JWT (email/password) | list_files, tr_search, read_file | Working, read-only by design |
| No backend route in either mode | read_document, write_document, delete_file | Always raise ValueError — not an auth restriction |
upsert_file is the only write tool with a working backend route, and it only writes when an agent key (RELAY_AGENT_KEY / RELAY_AGENT_KEYS) is configured. JWT mode calling upsert_file raises a clear ValueError naming agent-key mode as the fix, instead of a confusing 404.DELETE route server-side yet. If routes for these are ever added, they'd still follow the agent-key-only write policy above — JWT would stay read-only.For shared or server-side deployments, run as an HTTP server:
# Direct
uv run relay_mcp.py --transport http --port 8888
RELAY_CP_URL=https://cp.yourdomain.com \ RELAY_EMAIL=agent@yourdomain.com \ RELAY_PASSWORD=your-password \ docker compose up -d
docker pull deadalusevc/evc-team-relay-mcp:latest
By default the server binds to `127.0.0.1` (localhost-only) — the endpoint is not reachable over the network even if the host has a public IP. This matches the common case of a single MCP client on the same machine as the server.
Then configure your MCP client to connect via HTTP:
{
"mcpServers": { "evc-relay": { "type": "streamable-http", "url": "http://127.0.0.1:8888/mcp" } } }
If your MCP client runs on a different machine than the server, tunnel to the localhost-bound port instead of exposing it publicly:
# From the client machine, forward local 8888 to the server's localhost:8888
ssh -N -L 8888:127.0.0.1:8888 user@your-server
Then point the client config at http://127.0.0.1:8888/mcp as above — traffic goes through the SSH tunnel, and the server's bind address never needs to change.
If you genuinely need the server to accept connections from other hosts directly (e.g. it sits behind a reverse proxy that terminates TLS and handles auth), pass --host explicitly:
uv run relay_mcp.py --transport http --port 8888 --host 0.0.0.0
Only do this behind a reverse proxy or firewall — the MCP HTTP endpoint itself has no built-in authentication, so binding it to 0.0.0.0 on an open network exposes every relay tool call to anyone who can reach the port.
The MCP server provides significant security advantages over shell-based integrations:
ps output)Note: If you're using the OpenClaw skill (bash scripts), consider migrating to this MCP server for a more secure and maintainable integration.
┌─────────────┐ 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.
| Product | What it does | Link |
|---|---|---|
| Team Relay | Self-hosted collaboration server | repo |
| Team Relay Sync | Obsidian plugin for Team Relay | install / 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 |
-
Find us in other directories
MIT