claudio-audiobook

Name: claudio-audiobook
Author: restante

by restanteversion 0.2.0i★ –iRuns on your computer

Registry nameio.github.restante/claudio-audiobook

Install

Overview

Description from the maker (original English)

Make audiobooks locally with Kokoro voices from your AI assistant. Nothing leaves your computer.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: CLAUDIO_AUDIOBOOK_VOICE, CLAUDIO_AUDIOBOOK_SPEED, CLAUDIO_AUDIOBOOK_FORMAT, CLAUDIO_AUDIOBOOK_AUTHOR, CLAUDIO_AUDIOBOOK_OUTPUT

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "claudio-audiobook": {
      "command": "uvx",
      "args": [
        "claudio-audiobook"
      ],
      "env": {
        "CLAUDIO_AUDIOBOOK_VOICE": "your-value",
        "CLAUDIO_AUDIOBOOK_SPEED": "your-value",
        "CLAUDIO_AUDIOBOOK_FORMAT": "your-value",
        "CLAUDIO_AUDIOBOOK_AUTHOR": "your-value",
        "CLAUDIO_AUDIOBOOK_OUTPUT": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add claudio-audiobook --env CLAUDIO_AUDIOBOOK_VOICE=your-value --env CLAUDIO_AUDIOBOOK_SPEED=your-value --env CLAUDIO_AUDIOBOOK_FORMAT=your-value --env CLAUDIO_AUDIOBOOK_AUTHOR=your-value --env CLAUDIO_AUDIOBOOK_OUTPUT=your-value -- uvx claudio-audiobook

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "claudio-audiobook": {
      "command": "uvx",
      "args": [
        "claudio-audiobook"
      ],
      "env": {
        "CLAUDIO_AUDIOBOOK_VOICE": "your-value",
        "CLAUDIO_AUDIOBOOK_SPEED": "your-value",
        "CLAUDIO_AUDIOBOOK_FORMAT": "your-value",
        "CLAUDIO_AUDIOBOOK_AUTHOR": "your-value",
        "CLAUDIO_AUDIOBOOK_OUTPUT": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "claudio-audiobook": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "claudio-audiobook"
      ],
      "env": {
        "CLAUDIO_AUDIOBOOK_VOICE": "your-value",
        "CLAUDIO_AUDIOBOOK_SPEED": "your-value",
        "CLAUDIO_AUDIOBOOK_FORMAT": "your-value",
        "CLAUDIO_AUDIOBOOK_AUTHOR": "your-value",
        "CLAUDIO_AUDIOBOOK_OUTPUT": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

CLAUDIO_AUDIOBOOK_VOICE env
Default Kokoro voice, e.g. af_heart or a blend af_heart:0.6,af_sky:0.4
CLAUDIO_AUDIOBOOK_SPEED env
Default speed, 0.5 to 2.0
CLAUDIO_AUDIOBOOK_FORMAT env
Default format: m4b (chapters), mp3 or wav
CLAUDIO_AUDIOBOOK_AUTHOR env
Default author tag shown by audiobook players
CLAUDIO_AUDIOBOOK_OUTPUT env
Folder where audiobooks are saved (default ~/Audiobooks)

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 8, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account restante, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 18436 servers in this category
Published to the registry more recently than 67% of the other 18436 servers in this category
Basic checks equal to or better than 100% of the other 18436 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is claudio-audiobook safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.2.0) reached the registry 21 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Tethered Trust

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Runs in the cloud★ 211Updated 3 days ago

Install

Tethered Trust

by tetheredtrust.com

Fit, compatibility and recall checks for AI agents before they buy: verdicts, evidence, receipts.

Runs in the cloudUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

🎧 claudio-audiobook

An MCP server that lets your AI assistant make audiobooks

**Say *"create a python course audiobook"*. The AI writes it, a local voice reads it. Free, private, offline.**

Works with Claude Desktop · Claude Code · Cursor · VS Code (Copilot) · Gemini CLI · Codex CLI · any MCP client

Install · Listen · Examples · Voices · Settings

What it is

claudio-audiobook is a [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server. You add it to an AI assistant, and the assistant gains the ability to turn text into an audiobook on your computer. It is built and tested first for Claude (Desktop and Code, as a one-click extension and a plugin), and it works with other MCP-capable tools too. It also has a plain command line for use without any AI.

Tool	How to install
Claude Desktop	one-click `.mcpb` extension
Claude Code	plugin, or `claude mcp add`
Cursor	`mcp.json`
VS Code (GitHub Copilot)	`mcp.json`
Gemini CLI	`settings.json`
Codex CLI (OpenAI)	`config.toml`
Any other MCP client, or no AI	stdio command / command line

Not supported: web chat apps that cannot run local MCP servers (the ChatGPT and Gemini websites).

Why

Text-to-speech APIs charge per character and send your text to someone else's server. Audiobook apps only play books that already exist. claudio-audiobook closes the gap: you describe the audiobook you want, Claude writes it as spoken prose, and an 82M-parameter Kokoro voice reads it on your own machine.

	claudio-audiobook	Cloud TTS APIs	Audiobook apps
Creates the content for you	✅	❌	❌
Cost per hour of audio	£0	per-character fees	subscription
Text leaves your computer	Never	Always	n/a
API key or account	None	Required	Required
Chapters in the file (`.m4b`)	✅	DIY	✅
Works offline after setup	✅	❌	partly

Hear it

Real output, no editing. Voice bf_emma, from the text in docs/samples/python-intro.md:

▶ [python-intro-bf_emma.mp3](https://github.com/restante/claudio_audiobook/releases/download/v0.1.2/python-intro-bf_emma.mp3) (18 seconds, 109 KB)

That sample rendered in about 6 seconds on the author's Mac (CPU only). A real 11-chapter, 36-minute exam course took about 3 minutes.

Install in 60 seconds

You need uv for Claude Code (install it: macOS brew install uv, Windows winget install --id=astral-sh.uv -e). Everything else, including ffmpeg, is installed for you. The voice model (about 330 MB, once) downloads on first use.

Claude Code

/plugin marketplace add restante/claudio_audiobook

/plugin install claudio-audiobook --marketplace restante/claudio_audiobook

Prefer just the MCP server, without the skill?

claude mcp add claudio-audiobook -- uvx --from claudio-audiobook claudio-audiobook-mcp

Claude Desktop

Download claudio-audiobook- .mcpb from Releases.
Open it with Claude Desktop (Settings → Extensions).
Optional: set your default voice, speed and folder in the extension's settings.

Desktop installs the dependencies itself.

Want the Pocket TTS engine in Desktop? Install claudio-audiobook-pocket- .mcpb from the same Releases page *instead of* the standard one (install one or the other). It adds Pocket TTS (7 languages, voice cloning) and a "Default engine" setting. Its first launch downloads PyTorch and the voice engine, about 1 GB: under a minute on a fast connection in testing, longer on a slow one, and Claude may show the extension as failed until it finishes (wait, then reconnect).

Other AI tools

It is a standard MCP server (stdio), so it is not tied to Claude. Install it once, then point your tool at it:

uv tool install claudio-audiobook                                   # from PyPI; puts claudio-audiobook-mcp on your PATH

claudio-audiobook download-model # the voice model, about 330 MB, once claudio-audiobook doctor # checks everything is in place

Installing first matters: the first run of uvx has to download and install everything, which can exceed a client's start-up timeout. If your tool cannot find the command, use its full path (which claudio-audiobook-mcp).

Cursor · ~/.cursor/mcp.json or .cursor/mcp.json

"mcpServers": { "claudio-audiobook": { "type": "stdio", "command": "claudio-audiobook-mcp" } } }

</details>

VS Code (GitHub Copilot) · .vscode/mcp.json or run MCP: Open User Configuration

"servers": { "claudio-audiobook": { "type": "stdio", "command": "claudio-audiobook-mcp" } } }

Use agent mode so Copilot can call tools.

Gemini CLI · ~/.gemini/settings.json

"mcpServers": { "claudio-audiobook": { "command": "claudio-audiobook-mcp" } } }

or `gemini mcp add --scope user claudio-audiobook claudio-audiobook-mcp`. Check with `/mcp`.

Codex CLI (OpenAI) · ~/.codex/config.toml

[mcp_servers.claudio-audiobook]

command = "claudio-audiobook-mcp" startup_timeout_sec = 60

or `codex mcp add claudio-audiobook -- claudio-audiobook-mcp`. Codex waits only 10 seconds for a server to start

by default, so raise startup_timeout_sec as above. Check with codex mcp list.

Set defaults (voice, speed, folder) with CLAUDIO_AUDIOBOOK_* environment variables in the same config, for example "env": { "CLAUDIO_AUDIOBOOK_VOICE": "bf_emma" }. Any agent that can run a shell can also use the command line directly.

Status: the server was checked with a generic MCP stdio client (handshake, tool list, a dry run), and the

tool schemas are tested to avoid constructs that Cursor and Gemini mishandle. The configs above follow each

tool's current documentation but have not yet been run inside those tools. If one doesn't work for you,

please open an issue.

Examples

Just ask. Claude agrees the scope, writes the text, shows the chapter list and length, renders in the background and tells you where the file is.

A course from nothing

create a python course audiobook, for beginners, about an hour, in a calm British voice

Your own text

Turn ~/notes/book.md into an audiobook.

Steer it in plain English

slower · a different voice · mix af_heart and bf_emma 60/40 · longer pauses between sentences · make it mp3

Ideas people can do with it

🎓 Revision notes or an exam course you can listen to on the commute
📰 A long article or paper, read aloud while you cook
🧒 A bedtime story, in a voice you picked
🌍 Language practice: an Italian text read by if_sara, or an English text read with a French accent
💼 Onboarding docs or a team handbook as a podcast-style audio file

What you get

~/Audiobooks/python-for-beginners/

├── python-for-beginners.m4b ← one file, with chapter marks ├── 01-welcome.wav ├── 02-variables.wav └── ...

Command line

A real run (from docs/samples/python-intro.md): three chapters in, one .m4b with chapter marks out.

No Claude needed for text you already have:

uvx --from claudio-audiobook \

claudio-audiobook build book.md --voice bf_emma --speed 0.95

Preview before rendering. This is real output:

$ claudio-audiobook build course.md --dry-run

1 01-welcome.wav ~ 0.1 min 2 02-variables.wav ~ 0.1 min 3 03-loops.wav ~ 0.1 min 3 chapters, about 0.0 h of audio

Chapters start at # headings (or lines like Chapter 3); a file without headings is cut into parts. Interrupted? Run it again: finished chapters are kept, and only chapters whose text or settings changed are redone.

Play it anywhere: chapters, tags and cover art

The default output is an M4B, the standard audiobook file: AAC audio with chapter marks, the tags players use to file it under *Audiobooks* (title, author, narrator, genre "Audiobook"), and a cover.

Cover art is made for you, locally. Ask the AI for a look (*"a dark green cover"*): it picks the colours and passes them as cover_colors. Or give your own picture: *"use ~/Pictures/cover.png"* (--cover). A cover.jpg or cover.png you drop in the book's folder is used too. --cover none skips it.
Author and narrator come from the chat (*"by Ada Lovelace"*) or the --author flag. Set a default author once in the Desktop extension settings.
The generated cover uses the built-in Latin font: titles in Chinese, Japanese or Korean show empty boxes, so give those books their own cover image.

Import it into:

Where	How
Apple Books (Mac, iPhone, iPad)	drag the `.m4b` onto Books, or share it from Files
BookPlayer (iOS, chapters tested), Audiobookshelf, Plex	add it to the library folder or import it
Voice, Smart AudioBook Player, Listen (Android)	open the file or copy it to your audiobooks folder
VLC, Foobar2000	plays it. VLC for iOS did not show the chapter list in testing, so use BookPlayer or Apple Books for chapters

Choose --format mp3 for players that don't read M4B (some car stereos). Audible and Kindle use closed formats and cannot import it.

Optional second engine: Pocket TTS

Pocket TTS (Kyutai, 100M parameters) is an optional second voice engine. In th

Only the beginning is shown; read the rest in the repo

claudio-audiobook

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Tethered Trust

README from the maker

🎧 claudio-audiobook

An MCP server that lets your AI assistant make audiobooks

What it is

Why

Hear it

Install in 60 seconds

Claude Code

Claude Desktop

Other AI tools

Examples

Command line

Play it anywhere: chapters, tags and cover art

Optional second engine: Pocket TTS