Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Hume

FreeNot checked

Hume — Model Context Protocol server

GitHubEmbed

About

Hume — Model Context Protocol server

README

Hume MCP Server

Collaborate with AI assistants on your Text-to-Speech projects

📘 Documentation💬 Join us on Discord🔐 Getting your API Keys

The Hume MCP Server gives you the the ability to use Octave Text to Speech from within an AI Chat, using an MCP Client Application such as Claude Desktop, Cursor, or Windsurf.

Octave TTS is the first text-to-speech system built on LLM intelligence. Octave is a speech-language model that understands what words mean in context, unlocking a new level of expressiveness and nuance. It performs the source text, it doesn't just pronounce it.

See this video for a demonstration of using the MCP Server to narrate a scene from an audiobook.

Quickstart

Click here to add to Cursor:

Install MCP Server

Copy the following into your client's MCP configuration (for example, inside the .mcpServers property of claude_desktop_config.json for Claude Desktop, or of the mcp.json for Cursor).

{
    ...
    "hume": {
        "command": "npx",
        "args": [
            "@humeai/mcp-server"
        ],
        "env": {
            "HUME_API_KEY": "<your_hume_api_key>",
        }
    }
}

Prerequisites

  • An account and API Key from Hume AI
  • Node.js
  • (optional) A command-line audio player
    • ffplay from FFMpeg is recommended, but the server will attempt to detect and use any of several common players.

Available Tools

The server exposes the following MCP tools:

  • tts: Synthesize (and play) speech from text
  • play_previous_audio: Replay previously generated audio
  • list_voices: List available voices
  • save_voice: Save a generated voice to your library
  • delete_voice: Remove a voice from your library

Command Line Options

Options:
  --workdir, -w <path>       Set working directory for audio files (default: system temp)
  --(no-)embedded-audio-mode Enable/disable embedded audio mode (default: false)
  --help, -h                 Show this help message

Evaluation Framework

The project includes a comprehensive evaluation framework that measures how effectively AI agents can utilize the Hume TTS tools across various real-world scenarios.

Environment Variables

  • HUME_API_KEY: Your Hume AI API key (required)
  • WORKDIR: Working directory for audio files (default: system temp directory + "/hume-tts")
  • EMBEDDED_AUDIO_MODE: Enable/disable embedded audio mode (default: false, set to 'true' to enable)
  • ANTHROPIC_API_KEY: Required for running evaluations

from github.com/HumeAI/mcp-server-hume

Installing Hume

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/HumeAI/mcp-server-hume

FAQ

Is Hume MCP free?

Yes, Hume MCP is free — one-click install via Unyly at no cost.

Does Hume need an API key?

No, Hume runs without API keys or environment variables.

Is Hume hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Hume in Claude Desktop, Claude Code or Cursor?

Open Hume on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Compare Hume with

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs