delete-documents
Remove multiple documents by their IDs from a Meilisearch index using the MCP Server, simplifying document management and data cleanup.
Instructions
Delete multiple documents by their IDs from a Meilisearch index
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| documentIds | Yes | JSON array of document IDs to delete | |
| indexUid | Yes | Unique identifier of the index |
Implementation Reference
- src/tools/document-tools.ts:221-241 (handler)The main handler function for the delete-documents tool. It parses a JSON string of document IDs and performs a batch delete via the Meilisearch API using apiClient.post to /documents/delete-batch endpoint.async ({ indexUid, documentIds }: DeleteDocumentsParams) => { try { // Parse the document IDs string to ensure it's valid JSON const parsedDocumentIds = JSON.parse(documentIds); // Ensure document IDs is an array if (!Array.isArray(parsedDocumentIds)) { return { isError: true, content: [{ type: 'text', text: 'Document IDs must be a JSON array' }], }; } const response = await apiClient.post(`/indexes/${indexUid}/documents/delete-batch`, parsedDocumentIds); return { content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }], }; } catch (error) { return createErrorResponse(error); } }
- src/tools/document-tools.ts:217-220 (schema)Zod input schema defining parameters: indexUid (string) and documentIds (string containing JSON array of IDs).{ indexUid: z.string().describe('Unique identifier of the index'), documentIds: z.string().describe('JSON array of document IDs to delete'), },
- src/tools/document-tools.ts:213-242 (registration)Registration of the 'delete-documents' tool using server.tool(), including description, schema, and handler within the registerDocumentTools function.// Delete multiple documents by ID server.tool( 'delete-documents', 'Delete multiple documents by their IDs from a Meilisearch index', { indexUid: z.string().describe('Unique identifier of the index'), documentIds: z.string().describe('JSON array of document IDs to delete'), }, async ({ indexUid, documentIds }: DeleteDocumentsParams) => { try { // Parse the document IDs string to ensure it's valid JSON const parsedDocumentIds = JSON.parse(documentIds); // Ensure document IDs is an array if (!Array.isArray(parsedDocumentIds)) { return { isError: true, content: [{ type: 'text', text: 'Document IDs must be a JSON array' }], }; } const response = await apiClient.post(`/indexes/${indexUid}/documents/delete-batch`, parsedDocumentIds); return { content: [{ type: 'text', text: JSON.stringify(response.data, null, 2) }], }; } catch (error) { return createErrorResponse(error); } } );
- src/tools/document-tools.ts:45-48 (helper)TypeScript interface defining the parameters for the delete-documents handler, matching the schema.interface DeleteDocumentsParams { indexUid: string; documentIds: string; }
- src/index.ts:65-65 (registration)Top-level call to registerDocumentTools(server) which registers the 'delete-documents' tool among others.registerDocumentTools(server);