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:
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
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-humeFAQ
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
GitHub
PRs, issues, code search, CI status
by GitHubFilesystem
Secure file operations with configurable access controls.
Memory
Knowledge graph-based persistent memory system.
Template MCP Server
A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure
by mcpdotdirectCompare Hume with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All development MCPs
