Audible

CI npm version

audible-mcp is a TypeScript Model Context Protocol server for authenticated Audible read workflows.

It currently exposes signed-auth tools and resources for:

• library listing
• collection item listing
• library search
• in-progress title listing
• single library item lookup
• wishlist listing
• collections listing
• chapter lookup by ASIN
• content metadata by ASIN
• catalog product metadata by ASIN
• aggregate listening stats
• auth validation
• local auth status

Requirements

• Node.js 22+
• an Audible auth bundle created with the login flow in this repo or via the published CLI

Setup

You need an audible-auth.json file before running the MCP server.

If you are working from a local checkout:

npm install
npm run auth:login -- --marketplace us --file .\audible-auth.json

If you are using the published package:

npx audible-mcp auth login --marketplace us --file ./audible-auth.json

The login flow opens Audible/Amazon in your browser, then asks you to paste the final maplanding URL back into the terminal. The resulting audible-auth.json contains live credentials and should not be committed.

If the saved auth expires, refresh the auth bundle without re-registering the device.

Local checkout:

npm run auth:refresh -- --file .\audible-auth.json

Published package:

npx audible-mcp auth refresh --file ./audible-auth.json

Install Via npm

Run the published server directly with npx:

npx -y audible-mcp serve

Run The MCP Server

Start the stdio server directly:

$env:AUDIBLE_AUTH_FILE = ".\audible-auth.json"
npm run mcp:start

After npm publish, the equivalent command is:

AUDIBLE_AUTH_FILE=./audible-auth.json npx audible-mcp serve

Run the end-to-end MCP smoke test:

$env:AUDIBLE_AUTH_FILE = ".\audible-auth.json"
npm run smoke:test

Root Config Files

• mcp.config.json: local MCP client config for this checkout; gitignored
• mcp.config.example.json: committed template you can copy and edit for your machine

The local config uses the server command from this repo and points AUDIBLE_AUTH_FILE at the root auth bundle.

Example MCP Config

Using the published npm package:

{
  "mcpServers": {
    "audible": {
      "command": "npx",
      "args": ["-y", "audible-mcp", "serve"],
      "env": {
        "AUDIBLE_AUTH_FILE": "/path/to/audible-auth.json"
      }
    }
  }
}

Using a local checkout:

{
  "mcpServers": {
    "audible": {
      "command": "npm",
      "args": ["run", "mcp:start"],
      "cwd": "/path/to/audible-mcp",
      "env": {
        "AUDIBLE_AUTH_FILE": "/path/to/audible-mcp/audible-auth.json"
      }
    }
  }
}

The committed template in mcp.config.example.json uses the published package.

Available Tools

• audible_list_library
• audible_list_collection_items
• audible_search_library
• audible_list_in_progress_titles
• audible_get_library_item
• audible_list_wishlist
• audible_list_collections
• audible_get_chapters
• audible_get_content_metadata
• audible_get_catalog_product
• audible_get_listening_stats
• audible_validate_auth
• audible_get_auth_status

Available Resources

• audible://auth/status
• audible://wishlist
• audible://collections
• audible://collections/{collectionId}/items
• audible://library/{asin}
• audible://content/{asin}/metadata
• audible://catalog/{asin}

Development Scripts

• npm run auth:login
• npm run auth:refresh
• npm run mcp:start
• npm run smoke:test
• npm run typecheck
• npm run test
• npm run build
• npm run check

Notes

• Signed auth is the working API path in this repo.
• audible-auth.json contains private credentials and should be treated as a secret.
• The main CLI supports serve, auth login, and auth refresh.
• CI runs npm run check on pushes to master and on pull requests.

Security

• Do not commit audible-auth.json.
• If the auth bundle is ever exposed, revoke or replace it by generating a new device registration.
• mcp.config.json is local-only and should stay uncommitted.