# Yuva

> Yuva is an open-source MCP server for communication. MCP server for a self-hosted Yuva inbox: search, triage and draft support replies. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, API
- **Website:** https://useyuva.com
- **Repository:** https://github.com/productdevbook/yuva
- **MCP Registry name:** io.github.productdevbook/yuva
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

This server connects an AI assistant to your own Yuva installation rather than to a hosted service. You give it the server address and an API key, and the key's scopes and inboxes decide what the assistant can see and do. The registry entry describes searching, reading, triaging and drafting replies to e-mail and chat; drafts are reviewed and sent by a teammate.

It ships both as a stdio bundle (MCPB, version 0.5.0) and as a streamable HTTP endpoint at /mcp on your Yuva host. The README says the MCP server supports OAuth for Claude, Cursor, VS Code and other assistants.

Yuva is an open-source inbox for support e-mail, live chat and in-app messages, written in Go with Postgres. The server and panel are AGPL-3.0, the SDKs are MIT, and the project is in beta with no independent security audit.

## Features

- **Scoped API key:** Key scopes and inboxes limit what the assistant can touch.
- **Stdio or HTTP:** Run the MCPB bundle locally or connect to /mcp on your Yuva host.
- **Inbox search and triage:** Find and sort conversations across e-mail, chat and in-app messages.
- **Reviewed drafts:** Replies are drafted for a team member to check and send.
- **OAuth support:** The README lists OAuth for Claude, Cursor, VS Code and others.
- **Self-hosted:** Runs against your own Yuva server on one Docker image and Postgres.

## Good for

- Summarise open support conversations each morning
- Draft replies to common questions for review
- Triage new messages by label or urgency
- Search past conversations for a customer's history
- Check what an assistant can reach by limiting key scopes

## Install

### Claude Code (Terminal)

```sh
claude mcp add yuva --env YUVA_URL='<YUVA_URL>' --env YUVA_API_KEY='<YUVA_API_KEY>' -- npx -y https://github.com/productdevbook/yuva/releases/download/v0.5.0/yuva.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "yuva": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/productdevbook/yuva/releases/download/v0.5.0/yuva.mcpb"
      ],
      "env": {
        "YUVA_URL": "<YUVA_URL>",
        "YUVA_API_KEY": "<YUVA_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "yuva": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/productdevbook/yuva/releases/download/v0.5.0/yuva.mcpb"
      ],
      "env": {
        "YUVA_URL": "<YUVA_URL>",
        "YUVA_API_KEY": "<YUVA_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "yuva": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/productdevbook/yuva/releases/download/v0.5.0/yuva.mcpb"
      ],
      "env": {
        "YUVA_URL": "<YUVA_URL>",
        "YUVA_API_KEY": "<YUVA_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "yuva": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/productdevbook/yuva/releases/download/v0.5.0/yuva.mcpb"
      ],
      "env": {
        "YUVA_URL": "<YUVA_URL>",
        "YUVA_API_KEY": "<YUVA_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "yuva": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/productdevbook/yuva/releases/download/v0.5.0/yuva.mcpb"
      ],
      "env": {
        "YUVA_URL": "<YUVA_URL>",
        "YUVA_API_KEY": "<YUVA_API_KEY>"
      }
    }
  }
}
```

## FAQ

### What do I need to set it up?

A running Yuva server and an API key; the stdio bundle takes YUVA_URL and YUVA_API_KEY.

### Can the assistant send replies on its own?

The site says a teammate reviews and sends what the assistant drafts.

### Is it production ready?

The README marks Yuva as beta, says the API may change before 1.0, and notes there has been no independent security audit.

### What licence applies?

Yuva's server and panel are AGPL-3.0, and the SDKs and API contract are MIT.

### Is Yuva free?

Yes. Yuva is open source, so you can use and self-host it for free.

### How do I add Yuva to Claude Code?

Run this command in your terminal: claude mcp add yuva --env YUVA_URL='<YUVA_URL>' --env YUVA_API_KEY='<YUVA_API_KEY>' -- npx -y https://github.com/productdevbook/yuva/releases/download/v0.5.0/yuva.mcpb

### What are the best alternatives to Yuva?

The closest alternatives to Yuva are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/yuva
