Yuva — Claude Code MCP server: what it does, how to install
Connects your AI assistant to self-hosted Yuva customer messaging. Lets agents search incoming threads, triage customer tickets, and prepare draft replies to emails.
Open on GitHubWhat Yuva 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.
What it helps with
- 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 for the agent
- 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
How to install Yuva
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http yuva https://{yuva_host}/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add yuva --url https://{yuva_host}/mcp1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"yuva": {
"url": "https://{yuva_host}/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"yuva": {
"type": "http",
"url": "https://{yuva_host}/mcp"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http yuva https://{yuva_host}/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Yuva
How to install Yuva in Claude Code?
Run claude mcp add --transport http yuva https://{yuva_host}/mcp, replacing {yuva_host} with the host address of your deployed Yuva server.
What does the Yuva MCP server do?
It exposes customer support inboxes to the AI client, enabling ticket search, conversation review, and drafting replies for staff confirmation.
Does the assistant reply directly to users?
No. Assistant output stays in draft form unless you explicitly configure sending permissions, protecting the inbox from unvetted messages.
