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 | Default |
|---|---|---|---|
| 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
- 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, }, ], }; }
- 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,