`list_bookshelf`

Pack: google-books · Endpoint: https://gateway.pipeworx.io/google-books/mcp

Fetch the public bookshelves for a Google account (by numeric user_id). Omit shelf to list all public shelves; provide a numeric shelf id to list the volumes on that specific shelf.

Parameters

Name	Type	Required	Description
`user_id`	string	yes	Google account numeric user id
`shelf`	string	no	Shelf id (numeric) — omit to list all public shelves

Example call

Arguments

{
  "user_id": "118212570460635920423"
}

curl

curl -X POST https://gateway.pipeworx.io/google-books/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_bookshelf","arguments":{"user_id":"118212570460635920423"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('list_bookshelf', {
  "user_id": "118212570460635920423"
});

More examples

{
  "user_id": "118212570460635920423",
  "shelf": "1001"
}

Response shape

Full JSON Schema

{
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "description": "Resource kind (books#bookshelves)"
        },
        "shelves": {
          "type": "array",
          "description": "List of public bookshelves",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "number",
                "description": "Shelf numeric id"
              },
              "selfLink": {
                "type": "string",
                "description": "Link to shelf resource"
              },
              "title": {
                "type": "string",
                "description": "Shelf display title"
              },
              "description": {
                "type": "string",
                "description": "Shelf description"
              },
              "volumeCount": {
                "type": "number",
                "description": "Number of volumes in shelf"
              },
              "created": {
                "type": "string",
                "description": "Shelf creation timestamp"
              },
              "updated": {
                "type": "string",
                "description": "Shelf last update timestamp"
              }
            }
          }
        }
      }
    },
    {
      "type": "object",
      "properties": {
        "kind": {
          "type": "string",
          "description": "Resource kind (books#volumes)"
        },
        "totalItems": {
          "type": "number",
          "description": "Total volumes in shelf"
        },
        "items": {
          "type": "array",
          "description": "Array of volumes in specified shelf",
          "items": {
            "type": "object",
            "properties": {
              "kind": {
                "type": "string",
                "description": "Resource kind (books#volume)"
              },
              "id": {
                "type": "string",
                "description": "Volume id"
              },
              "etag": {
                "type": "string",
                "description": "Entity tag for caching"
              },
              "selfLink": {
                "type": "string",
                "description": "Link to volume resource"
              },
              "volumeInfo": {
                "type": "object",
                "description": "Volume metadata"
              }
            }
          }
        }
      }
    }
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "google-books": {
      "url": "https://gateway.pipeworx.io/google-books/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

list_bookshelf