Hume MCP Server
Description
<div align="center"> <img src="https://storage.googleapis.com/hume-public-logos/hume/hume-banner.png"> <h1>Hume MCP Server</h1> <p> <strong>Collaborate with AI assistants on your Text-to-Speech projects</strong> </p> <p> <a…
About
<div align="center"> <img src="https://storage.googleapis.com/hume-public-logos/hume/hume-banner.png"> <h1>Hume MCP Server</h1> <p> <strong>Collaborate with AI assistants on your Text-to-Speech projects</strong> </p> <p> <a href="https://dev.hume.ai/docs/text-to-speech-tts/mcp-server">📘 Documentation</a> • <a…
Details
- Author
- HumeAI
- Downloads
- 144
- Categories
- Other
Jump to
- Synthesize speech from text using Octave TTS.
- Replay previously generated audio.
- List, save, and delete voices in your library.
- Configurable working directory for audio files.
- Optional instant mode (10% extra cost) or embedded audio mode.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Hume MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Add the provided JSON configuration to your MCP client's settings (e.g., claude_desktop_config.json), set your HUME_API_KEY environment variable, and install Node.js (a command-line audio player like ffplay is optional). The server exposes tools that can be called directly from the AI chat.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"hume mcp server": {
"hume": {
"command": "npx",
"args": [
"@humeai/mcp-server"
],
"env": {
"HUME_API_KEY": ""
}
}
}
}
}McpServers
{
"hume": {
"command": "npx",
"args": [
"@humeai/mcp-server"
],
"env": {
"HUME_API_KEY": ""
}
}
}<div align="center">
<h1>Hume MCP Server</h1>
<p>
<strong>Collaborate with AI assistants on your Text-to-Speech projects</strong>
</p>
<p>
<a href="https://dev.hume.ai/docs/text-to-speech-tts/mcp-server">📘 Documentation</a> •
<a href="https://discord.com/invite/humeai">💬 Join us on Discord</a> •
<a href="https://dev.hume.ai/docs/introduction/api-key">🔐 Getting your API Keys</a>
</p>
</div>
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
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)
--(no-)instant-mode Enable/disable instant mode (default: false) (incurs 10% additional cost)
--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)
- INSTANT_MODE: Enable/disable instant mode (default: false, set to 'true' to enable)
- ANTHROPIC_API_KEY: Required for running evaluations
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
