Readwise Reader MCP Server

Instructions

Implementation Reference

• src/handlers/document-handlers.ts:210-229 (handler)

  The handleDeleteDocument function implements the core logic for the readwise_delete_document tool. It initializes the Readwise client, calls deleteDocument(id), handles any messages, and returns a formatted text response.

  export async function handleDeleteDocument(args: any) {
    const client = initializeClient();
    const { id } = args as { id: string };
    const response = await client.deleteDocument(id);
  
    let responseText = `Document ${id} deleted successfully!`;
    
    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:132-145 (schema)

  The tool definition including name, description, and input schema for validating the document ID parameter.

    name: 'readwise_delete_document',
    description: 'Delete a document from Readwise Reader',
    inputSchema: {
      type: 'object',
      properties: {
        id: {
          type: 'string',
          description: 'Document ID to delete',
        },
      },
      required: ['id'],
      additionalProperties: false,
    },
  },

• src/handlers/index.ts:20-21 (registration)

  The switch case in handleToolCall that registers and dispatches to the handleDeleteDocument handler for the 'readwise_delete_document' tool.

  case 'readwise_delete_document':
    return handleDeleteDocument(args);

• src/handlers/index.ts:1-6 (registration)

  Import statement that brings in the handleDeleteDocument function used by the tool dispatcher.

  import { 
    handleSaveDocument, 
    handleListDocuments, 
    handleUpdateDocument, 
    handleDeleteDocument 
  } from './document-handlers.js';