readwise_save_document
Save web documents or HTML content to Readwise Reader for organized reading and reference, supporting tags, categories, and custom locations.
Instructions
Save a document (URL or HTML content) to Readwise Reader
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | URL of the document to save | |
| html | No | HTML content of the document (optional) | |
| tags | No | Tags to add to the document | |
| location | No | Location to save the document (default: new) | |
| category | No | Category of the document (auto-detected if not specified) |
Implementation Reference
- src/handlers/document-handlers.ts:5-24 (handler)The main handler function for the 'readwise_save_document' tool. It initializes the Readwise client, casts arguments to CreateDocumentRequest, calls client.createDocument(), formats a success response with document details and any messages, and returns it in MCP content format.export async function handleSaveDocument(args: any) { const client = initializeClient(); const data = args as unknown as CreateDocumentRequest; const response = await client.createDocument(data); let responseText = `Document saved successfully!\nID: ${response.data.id}\nTitle: ${response.data.title || 'Untitled'}\nURL: ${response.data.url}\nLocation: ${response.data.location}`; 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:4-37 (schema)The input schema definition for the 'readwise_save_document' tool, specifying parameters like url (required), html, tags, location, and category with types and descriptions.{ name: 'readwise_save_document', description: 'Save a document (URL or HTML content) to Readwise Reader', inputSchema: { type: 'object', properties: { url: { type: 'string', description: 'URL of the document to save', }, html: { type: 'string', description: 'HTML content of the document (optional)', }, tags: { type: 'array', items: { type: 'string' }, description: 'Tags to add to the document', }, location: { type: 'string', enum: ['new', 'later', 'shortlist', 'archive', 'feed'], description: 'Location to save the document (default: new)', }, category: { type: 'string', enum: ['article', 'book', 'tweet', 'pdf', 'email', 'youtube', 'podcast'], description: 'Category of the document (auto-detected if not specified)', }, }, required: ['url'], additionalProperties: false, }, },
- src/handlers/index.ts:11-12 (registration)The switch case in the main handleToolCall function that registers and routes 'readwise_save_document' calls to the handleSaveDocument handler.case 'readwise_save_document': return handleSaveDocument(args);