mcp-elevenreader
MCP server for ElevenReader — ElevenLabs text-to-speech reader.
Setup
1. Get refresh token
Open https://elevenreader.io, log in, then run in browser console (F12 → Console):
JSON.parse(localStorage.getItem(Object.keys(localStorage).find(k => k.startsWith('firebase:authUser:')))).stsTokenManager.refreshToken
2. Configure MCP
Add to your MCP config (~/.kiro/settings.json, Claude Desktop, etc.):
{
"mcpServers": {
"elevenreader": {
"command": "uv",
"args": ["run", "--directory", "/path/to/mcp-elevenreader", "python", "server.py"],
"env": {
"ELEVEN_REFRESH_TOKEN": "paste-your-refresh-token-here"
}
}
}
}
The refresh token is long-lived (months). Access tokens are refreshed automatically.
Tools
| Tool | Description |
|---|---|
list_reads |
List all documents/books in library |
get_read |
Get read details (chapters, progress) |
get_read_content |
Get HTML text content |
add_url |
Add URL for TTS reading |
add_document |
Upload epub/pdf file |
add_directory |
Upload all books from a directory (background, with retry) |
upload_status |
Check background upload progress |
delete_read |
Remove from library |
deduplicate |
Find and remove duplicate reads (keeps oldest) |
list_voices |
Available voices |
get_voice |
Voice details |
get_config |
User settings |
update_config |
Change voice/speed |
get_customer |
Subscription & credits |
get_collections |
User collections |
get_bookmarks |
Bookmarks for a read |
update_progress |
Update listening position |
