# Yuva

Connects your AI assistant to self-hosted Yuva customer messaging. Lets agents search incoming threads, triage customer tickets, and prepare draft replies to emails.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 25
- Author: productdevbook
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/productdevbook/yuva
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/yuva

## What it does

This server hooks AI assistants up to the Yuva platform through its `/mcp` HTTP route. The model can inspect communication channels across multiple products and compose draft answers. User text is treated as unverified data, so the assistant writes drafts rather than firing off unreviewed messages.

You need an active self-hosted Yuva instance backed by PostgreSQL and Go behind an HTTPS proxy. Access relies on OAuth authentication. Keep in mind that Yuva is currently in beta: schema migrations execute automatically on boot, making regular database backups mandatory before updating.

The integration will not work without your own running Yuva host. It fits workspaces wanting to automate triage while keeping human oversight on all outgoing mail.

## Requirements
- Needs: Docker
- Remote server: `https://{yuva_host}/mcp`
- Environment variables: `YUVA_URL`, `YUVA_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http yuva https://{yuva_host}/mcp
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add yuva --url https://{yuva_host}/mcp
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yuva": {
            "url": "https://{yuva_host}/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "yuva": {
            "type": "http",
            "url": "https://{yuva_host}/mcp"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http yuva https://{yuva_host}/mcp
```

## When to use it
- find unresolved support conversations across multiple products
- generate draft responses for customer emails and live chat tickets
- inspect customer communication history before drafting a reply
- triage shared inbox threads based on topic or sender

## Example prompts
- Search Yuva for open customer tickets received today
- Read the latest email thread from support and draft a reply
- Summarize recent customer messages and categorize their complaints

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md