Skip to content
MCP server

Yuva

MCP server for a self-hosted Yuva inbox: search, triage and draft support replies

Install
Pricing
Open source
Platforms
self-hosted, API
Runs
Locally or Remotely
Version
0.5.0
Listing updated
3 days ago

About Yuva

Yuva is an open-source MCP server for communication. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Configuration

  • YUVA_URLYour Yuva server, for example https://support.example.comRequired
  • YUVA_API_KEYA Yuva API key; its scopes and inboxes limit what the assistant can doRequired

What it does

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

Pricing

Open source

Open source (AGPL-3.0 server, MIT SDKs); self-hosted. A hosted option is mentioned but prices are not published.

Prices change. Check useyuva.com before you buy.

Yuva 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 to Yuva

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity