readwise_update_document

Modify document details in Readwise Reader by updating title, author, summary, category, location, or metadata to keep your reading materials organized and current.

Instructions

Update a document in Readwise Reader

Input Schema

TableJSON Schema

Name	Required	Description
`id`	Yes	Document ID to update
`title`	No	New title for the document
`author`	No	New author for the document
`summary`	No	New summary for the document
`published_date`	No	New published date (ISO 8601)
`image_url`	No	New image URL for the document
`location`	No	New location for the document
`category`	No	New category for the document

Implementation Reference

src/handlers/document-handlers.ts:287-306 (handler)

The core handler function that implements the readwise_update_document tool. It extracts the document ID and update data from args, calls the Readwise client's updateDocument method, formats a success response with ID and URL, appends any messages, and returns it in the expected MCP content format.

export async function handleUpdateDocument(args: any) {
  const client = initializeClient();
  const { id, ...updateData } = args as unknown as { id: string } & UpdateDocumentRequest;
  const response = await client.updateDocument(id, updateData);

  let responseText = `Document updated successfully!\nID: ${response.data.id}\nReader URL: ${response.data.url}`;
  
  if (response.messages && response.messages.length > 0) {
    responseText += '\n\nMessages:\n' + response.messages.map(msg => `${msg.type.toUpperCase()}: ${msg.content}`).join('\n');
  }

  return {
    content: [
      {
        type: 'text',
        text: responseText,
      },
    ],
  };
}

src/tools/tool-definitions.ts:103-147 (schema)

The input schema definition for the readwise_update_document tool, specifying parameters like id (required), title, author, summary, etc., with enums for location and category.

{
  name: 'readwise_update_document',
  description: 'Update a document in Readwise Reader',
  inputSchema: {
    type: 'object',
    properties: {
      id: {
        type: 'string',
        description: 'Document ID to update',
      },
      title: {
        type: 'string',
        description: 'New title for the document',
      },
      author: {
        type: 'string',
        description: 'New author for the document',
      },
      summary: {
        type: 'string',
        description: 'New summary for the document',
      },
      published_date: {
        type: 'string',
        description: 'New published date (ISO 8601)',
      },
      image_url: {
        type: 'string',
        description: 'New image URL for the document',
      },
      location: {
        type: 'string',
        enum: ['new', 'later', 'shortlist', 'archive', 'feed'],
        description: 'New location for the document',
      },
      category: {
        type: 'string',
        enum: ['article', 'book', 'tweet', 'pdf', 'email', 'youtube', 'podcast'],
        description: 'New category for the document',
      },
    },
    required: ['id'],
    additionalProperties: false,
  },
},

src/handlers/index.ts:26-27 (registration)
The switch case registration in the main handleToolCall function that routes 'readwise_update_document' calls to the handleUpdateDocument handler.
```
case 'readwise_update_document':
  return handleUpdateDocument(args);
```
src/handlers/index.ts:1-4 (registration)
The import statement that brings in the handleUpdateDocument function from document-handlers.ts (noted as .js in source, likely transpiled). Note: lines 1-6 cover multiple document handlers.
```
import { 
  handleSaveDocument, 
  handleListDocuments, 
  handleUpdateDocument, 
```

Readwise MCP Enhanced