Converts text into speech using over 2,000 voices in 149 languages, providing MP3 links directly within your AI assistant.
Also known as freetts/mcp, mcp, @freetts/mcp
- Stars
- 0
- Tools
- 7
- Downloads, 30 days
- 190
- Latest version
- 1.0.5
- Last commit
- Nov 13, 2026
- License
- MIT
What is FreeTTS MCP?
FreeTTS converts text into speech using over 2,000 voices in 149 languages, providing MP3 links directly within your AI assistant. It exposes 7 tools, such as list_voices, suggest_voice, text_to_speech.
Summary generated from the project's README
About FreeTTS MCP server
FreeTTS provides text-to-speech capabilities directly within various AI assistants like Claude, ChatGPT, Cursor, and VS Code. It functions as a remote server that requires no local installation, allowing users to receive MP3 links for spoken text through their preferred MCP client. The service offers access to over 2,000 voices across 149 different languages.
Users can access standard tools for free without an account, though these requests are limited to 2,000 characters per call and include a short spoken tag at the end of the audio. For more advanced needs, a FreeTTS key or PRO account enables high-definition voices, WAV format support, and specialized tools like dialogue-to-speech and audio transcription. The server can be connected via a hosted URL or run locally using npx with an API key for more control.
What you can do with it
- 1Generate spoken audio from textAsk your AI assistant to convert a specific block of text into an MP3 file.
Written from the project's README. Every use case is checked against a quote from it.
How to install FreeTTS MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall FreeTTS MCP in Claude Code
$ claude mcp add --env 'FREETTS_API_KEY=<YOUR_FREETTS_API_KEY>' mcp -- npx -y @freetts/mcpInstall FreeTTS MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@freetts/mcp"
],
"env": {
"FREETTS_API_KEY": "<YOUR_FREETTS_API_KEY>"
}
}
}
}Install FreeTTS MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@freetts/mcp"
],
"env": {
"FREETTS_API_KEY": "<YOUR_FREETTS_API_KEY>"
}
}
}
}Install FreeTTS MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@freetts/mcp"],"env":{"FREETTS_API_KEY":"<YOUR_FREETTS_API_KEY>"}}'Install FreeTTS MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@freetts/mcp"
],
"env": {
"FREETTS_API_KEY": "<YOUR_FREETTS_API_KEY>"
}
}
}
}Install FreeTTS MCP in Codex
$ codex mcp add mcp --env 'FREETTS_API_KEY=<YOUR_FREETTS_API_KEY>' -- npx -y @freetts/mcpInstall FreeTTS MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@freetts/mcp"] [mcp_servers.mcp.env] FREETTS_API_KEY = "<YOUR_FREETTS_API_KEY>"
Install FreeTTS MCP in Gemini CLI
$ gemini mcp add -s user -e 'FREETTS_API_KEY=<YOUR_FREETTS_API_KEY>' mcp npx -- -y @freetts/mcpInstall FreeTTS MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@freetts/mcp"
],
"env": {
"FREETTS_API_KEY": "<YOUR_FREETTS_API_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @freetts/mcp 1.0.5 in an isolated container with no network and no keys. It answered and listed 7 tools.
FreeTTS MCP tools 7
Read from the server with tools/listlist_voicesRead-onlyList FreeTTS voices for a language or a search word, with the voice id to pass to text_to_speech. Says which voices are free and which need a FreeTTS PRO key (HD and Signature). Use it when the user names a language, accent or gender, or asks what voices exist.
suggest_voiceRead-onlySuggest three FreeTTS voices for a language and a use (audiobook, tutorial, ad, news, children's story, meditation, podcast), with a short reason each. Use it when the user has not named a voice.
text_to_speechActionConvert text to spoken audio with a FreeTTS voice and return a download link to the MP3 (or WAV with a FreeTTS PRO key). Use it when the user wants text read aloud, narrated, or saved as an audio file. Without a FreeTTS key: standard voices, up to 2,000 characters a call, a short spoken "FreeTTS" tag at the end, file kept one hour. With a key: the account's plan (PRO: HD and Signature voices, no tag, 10,000 characters a call, files kept 30 days).
check_usageRead-onlyShow the FreeTTS plan behind this connection and what is left: characters today or this month, requests a minute, HD voices, watermark. Use it when the user asks about limits, their plan, or why a request was refused.
dialogue_to_speechActionTurn a script with several speakers into one audio file, a different FreeTTS voice per speaker, with a pause between lines. Write each line as 'Name: text'. Use it for two-host shows, interviews, scenes, language lessons with two speakers. Needs a connected FreeTTS PRO account.
script_to_tracksActionRecord a script with exact timing, the way FreeTTS Script mode does: (pause 2) is exactly 2 seconds of silence, (beep), (ding) and (click) play a sound, 'CUE:' lines are read in a second voice, 'TRACK: name' starts a new audio file, 'NAME: line' makes a scene with a voice per character. Returns one file with everything plus one file per track. Use it for ear prompter tracks, voiceovers timed to footage, rehearsal tracks, workout or recipe step audio. Needs a connected FreeTTS PRO account.
transcribe_audioRead-onlyTurn a recording into text with FreeTTS speech to text. Give a public https URL to an audio file (mp3, wav, m4a, ogg, webm). Needs a connected FreeTTS PRO account.
Configuration
FREETTS_API_KEYSecretYour FreeTTS API key from https://freetts.org/dashboard (API keys). A free key works; PRO adds HD voices, WAV, dialogue, Script mode and transcription.
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablefreetts/mcp is public and reachablegithub.com/freetts/mcp ↗Pass
- Package names this repository as its source@freetts/mcp names freetts/mcp as sourcenpmjs.com/package/@freetts/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-12github.com/freetts/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @freetts/mcpPass
- No critical advisory in the package or its dependencies99 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 69 msPass
README
View on GitHubFreeTTS MCP server
Text to speech inside Claude, ChatGPT, Cursor, VS Code, Codex, Windsurf, Gemini CLI and any other MCP client. One remote server, nothing to install:
https://mcp.freetts.org/mcp
Ask your assistant to read something aloud, and it calls FreeTTS and hands you an MP3 link.
What it does
| Tool | What it does | Needs |
|---|---|---|
text_to_speech |
Text in, MP3 link out. 2,253 voices in 149 languages. | Nothing. Free without an account. |
list_voices |
Voices for a language or search word, with ids. | Nothing |
suggest_voice |
Three voices for a language and a use, with reasons. | Nothing |
check_usage |
Plan and characters left. | Nothing |
dialogue_to_speech |
Name: line script, a voice per speaker, one file. |
FreeTTS PRO |
script_to_tracks |
Script mode: exact (pause 2), (beep), (ding), TRACK: files, CUE: voice, scenes. |
FreeTTS PRO |
transcribe_audio |
A public audio URL in, text out. | FreeTTS PRO |
Free without a key: standard voices, 2,000 characters a call and a day per connection, 10 requests a minute, a short spoken "FreeTTS" tag at the end, files kept one hour.
With a FreeTTS key (free account or PRO): the account's plan. PRO: HD and Signature voices, no tag, 10,000 characters a call, 1,000,000 a month, WAV, files kept 30 days, and the dialogue, Script mode and transcription tools. Keys: freetts.org/dashboard (API keys).
Add it to your client
Claude Code
claude mcp add --transport http freetts https://mcp.freetts.org/mcp
With a key: add --header "Authorization: Bearer ft_live_...", or run /mcp inside a session to connect with the sign-in flow.
Claude (web, desktop, mobile): Settings, Connectors, Add custom connector, paste https://mcp.freetts.org/mcp. Free tools work at once; when a tool needs your account Claude shows Connect.
Cursor: Install in Cursor, or in ~/.cursor/mcp.json:
{ "mcpServers": { "freetts": { "url": "https://mcp.freetts.org/mcp" } } }
VS Code: Install in VS Code, or in .vscode/mcp.json:
{ "servers": { "freetts": { "type": "http", "url": "https://mcp.freetts.org/mcp" } } }
Codex CLI and ChatGPT desktop
codex mcp add freetts --url https://mcp.freetts.org/mcp
ChatGPT (web): Settings, Apps (Developer Mode), add https://mcp.freetts.org/mcp.
Windsurf, ~/.codeium/windsurf/mcp_config.json:
{ "mcpServers": { "freetts": { "serverUrl": "https://mcp.freetts.org/mcp" } } }
Any other client: use https://mcp.freetts.org/mcp as the server URL (Streamable HTTP). To use your account without the sign-in flow, send your key as Authorization: Bearer ft_live_... or x-api-key: ft_live_....
Full guide with copy buttons: freetts.org/developers/mcp.
Sign-in (OAuth)
The server is an OAuth 2.1 authorization server (PKCE, dynamic client registration, client ID metadata documents, RFC 9728 and 8414 metadata). Free tools need no sign-in. When a client calls a tool that needs your account, the server answers 401 and the client shows its Connect flow; the page asks for a FreeTTS API key from your dashboard and binds the connection to it. Delete the key in the dashboard to disconnect every assistant that used it.
Privacy
The text you send is sent to FreeTTS and its speech providers exactly as from the website, under the FreeTTS privacy policy. Calls without a key are metered by the caller's IP address. The server logs tool name, plan, character count, client name and outcome, never the text.
Run it locally (stdio)
The same server also runs on your own machine, for clients that start local servers or when you would rather keep a key in a local config. It talks to the public FreeTTS API with your own key. Get one at freetts.org/dashboard (API keys; a free account has one).
FREETTS_API_KEY=ft_live_... npx -y @freetts/mcp
Claude Desktop, Cursor, Cline, Windsurf and similar clients:
{
"mcpServers": {
"freetts": {
"command": "npx",
"args": ["-y", "@freetts/mcp"],
"env": { "FREETTS_API_KEY": "ft_live_..." }
}
}
}
Without a key it still starts: list_voices, suggest_voice, the prompts and the resources work, and making audio asks for a key. The hosted server at https://mcp.freetts.org/mcp needs no key at all.
From source: npm install && npm run build && node dist/stdio.js. Node.js 20 or later.
The hosted server itself (dist/index.js) runs next to the FreeTTS API on FreeTTS's own machines and is not meant to be self-hosted; the code is here so you can read exactly what it does.
License: MIT.
FreeTTS MCP questions
How do I add FreeTTS MCP to Claude Code?
Run claude mcp add --env 'FREETTS_API_KEY=<YOUR_FREETTS_API_KEY>' mcp -- npx -y @freetts/mcp in your terminal. Add --scope user to make it available in every project.
How do I add FreeTTS MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does FreeTTS MCP provide?
It exposes 7 tools, including list_voices, suggest_voice, text_to_speech, check_usage, dialogue_to_speech.
Do I need an account to use FreeTTS?
No, standard voices and basic tools are free to use without an account.
What are the limitations of the free tier?
The free tier includes standard voices, a limit of 2,000 characters per call and per day, 10 requests per minute, and a short 'FreeTTS' tag at the end of files.
Can I use FreeTTS with Claude or Cursor?
Yes, it can be added to Claude (web, desktop, mobile), Cursor, VS Code, and several other MCP clients via a URL or local installation.