# FreeTTS MCP server

> Converts text into speech using over 2,000 voices in 149 languages, providing MP3 links directly within your AI assistant.

- Repository: https://github.com/freetts/mcp
- Page: https://hostedmcp.org/servers/freetts/mcp
- Transport: stdio, remote
- Stars: 0
- License: MIT
- Latest version: 1.0.5

## Install

### Claude Code

```sh
claude mcp add --env 'FREETTS_API_KEY=<YOUR_FREETTS_API_KEY>' mcp -- npx -y @freetts/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@freetts/mcp"
      ],
      "env": {
        "FREETTS_API_KEY": "<YOUR_FREETTS_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@freetts/mcp"
      ],
      "env": {
        "FREETTS_API_KEY": "<YOUR_FREETTS_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@freetts/mcp"],"env":{"FREETTS_API_KEY":"<YOUR_FREETTS_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@freetts/mcp"
      ],
      "env": {
        "FREETTS_API_KEY": "<YOUR_FREETTS_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add mcp --env 'FREETTS_API_KEY=<YOUR_FREETTS_API_KEY>' -- npx -y @freetts/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "@freetts/mcp"]

[mcp_servers.mcp.env]
FREETTS_API_KEY = "<YOUR_FREETTS_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'FREETTS_API_KEY=<YOUR_FREETTS_API_KEY>' mcp npx -- -y @freetts/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@freetts/mcp"
      ],
      "env": {
        "FREETTS_API_KEY": "<YOUR_FREETTS_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `FREETTS_API_KEY` | no | yes | Your FreeTTS API key from https://freetts.org/dashboard (API keys). A free key works; PRO adds HD voices, WAV, dialogue, Script mode and transcription. |

## Tools (7)

- `list_voices`: List 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. (read-only)
- `suggest_voice`: Suggest 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. (read-only)
- `text_to_speech`: Convert 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_usage`: Show 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. (read-only)
- `dialogue_to_speech`: Turn 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_tracks`: Record 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_audio`: Turn 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. (read-only)

## FAQ

### 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.
