Audiobookshelf MCP Server
by jeeftorio.github.jeeftor/abs-mcpv0.6.0
Inspect and safely operate Audiobookshelf libraries over MCP.
context tax
queued
security
queued
cold start
queued
freshness
Maintained58d ago
Install Audiobookshelf MCP server
Install in Claude Code
claude mcp add abs-jeeftor -e ABS_BASE_URL='<abs-base-url>' -e ABS_API_KEY='<abs-api-key>' -e ABS_HTTP_BEARER_TOKEN='<abs-http-bearer-token>' -- docker run -i --rm -e ABS_BASE_URL -e ABS_API_KEY -e ABS_HTTP_BEARER_TOKEN ghcr.io/jeeftor/abs-mcp:0.6.0Install in Cursor
{
"mcpServers": {
"abs-jeeftor": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ABS_BASE_URL",
"-e",
"ABS_API_KEY",
"-e",
"ABS_HTTP_BEARER_TOKEN",
"ghcr.io/jeeftor/abs-mcp:0.6.0"
],
"env": {
"ABS_BASE_URL": "<abs-base-url>",
"ABS_API_KEY": "<abs-api-key>",
"ABS_HTTP_BEARER_TOKEN": "<abs-http-bearer-token>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"abs-jeeftor": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ABS_BASE_URL",
"-e",
"ABS_API_KEY",
"-e",
"ABS_HTTP_BEARER_TOKEN",
"ghcr.io/jeeftor/abs-mcp:0.6.0"
],
"env": {
"ABS_BASE_URL": "<abs-base-url>",
"ABS_API_KEY": "<abs-api-key>",
"ABS_HTTP_BEARER_TOKEN": "<abs-http-bearer-token>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"abs-jeeftor": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ABS_BASE_URL",
"-e",
"ABS_API_KEY",
"-e",
"ABS_HTTP_BEARER_TOKEN",
"ghcr.io/jeeftor/abs-mcp:0.6.0"
],
"env": {
"ABS_BASE_URL": "<abs-base-url>",
"ABS_API_KEY": "<abs-api-key>",
"ABS_HTTP_BEARER_TOKEN": "<abs-http-bearer-token>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"abs-jeeftor": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ABS_BASE_URL",
"-e",
"ABS_API_KEY",
"-e",
"ABS_HTTP_BEARER_TOKEN",
"ghcr.io/jeeftor/abs-mcp:0.6.0"
],
"env": {
"ABS_BASE_URL": "<abs-base-url>",
"ABS_API_KEY": "<abs-api-key>",
"ABS_HTTP_BEARER_TOKEN": "<abs-http-bearer-token>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ABS_BASE_URL | yes | — | Base URL of your Audiobookshelf server. |
| ABS_API_KEY | yes | yes | Audiobookshelf API key or bearer token. |
| ABS_READ_ONLY | — | — | Set to false to enable scan and cleanup tools. |
| ABS_TIMEOUT | — | — | Audiobookshelf request timeout as a Go duration or seconds. |
| ABS_FIXTURE_DIR | — | — | Optional local ABS fixture directory for fixture resources. |
| ABS_EXTRA_HEADERS_FILE | — | — | Optional JSON file containing extra request headers. |
| ABS_TLS_CA_CERT_FILE | — | — | Optional PEM CA bundle for private or corporate ABS TLS. |
| ABS_TLS_INSECURE_SKIP_VERIFY | — | — | Temporary TLS verification bypass for local troubleshooting. |
| ABS_TRANSPORT | — | — | MCP transport to run at startup. Use stdio for local launchers or http for Streamable HTTP. |
| ABS_HTTP_ADDR | — | — | Bind address used when ABS_TRANSPORT=http. |
| ABS_HTTP_PATH | — | — | Streamable HTTP endpoint path used when ABS_TRANSPORT=http. |
| ABS_HTTP_BEARER_TOKEN | — | yes | Optional bearer token required from Streamable HTTP MCP clients. |
Freshness
Maintained — last maintenance signal 58d ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-12 · 58d ago · GitHub
Latest release
2026-07-29 · 2mo ago · GitHub · v0.6.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-29 · 2mo ago · official registry · v0.6.0
FAQ
›How do I install the Audiobookshelf MCP server in Claude Code?
Run: claude mcp add abs-jeeftor -e ABS_BASE_URL='<abs-base-url>' -e ABS_API_KEY='<abs-api-key>' -e ABS_HTTP_BEARER_TOKEN='<abs-http-bearer-token>' -- docker run -i --rm -e ABS_BASE_URL -e ABS_API_KEY -e ABS_HTTP_BEARER_TOKEN ghcr.io/jeeftor/abs-mcp:0.6.0. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Audiobookshelf require an API key?
Yes. It expects ABS_BASE_URL, ABS_API_KEY, ABS_HTTP_BEARER_TOKEN, of which 2 are secrets.
›Can I use Audiobookshelf as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Audiobookshelf in the official MCP registry?
Yes, as io.github.jeeftor/abs-mcp.