bulk_mark_read
Mark multiple emails as read or unread in bulk by providing an array of email IDs and a read status.
Instructions
Mark multiple emails as read/unread
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| emailIds | Yes | Array of email IDs to mark | |
| read | No | true to mark as read, false as unread |
Implementation Reference
- src/index.ts:848-866 (registration)Tool registration for 'bulk_mark_read' in the ListToolsRequestSchema handler. Defines the tool name, description, and inputSchema (emailIds array and optional read boolean).
name: 'bulk_mark_read', description: 'Mark multiple emails as read/unread', inputSchema: { type: 'object', properties: { emailIds: { type: 'array', items: { type: 'string' }, description: 'Array of email IDs to mark', }, read: { type: 'boolean', description: 'true to mark as read, false as unread', default: true, }, }, required: ['emailIds'], }, }, - src/index.ts:1639-1654 (handler)Handler case for 'bulk_mark_read' in the CallToolRequestSchema handler. Extracts emailIds and read from args, validates the array, and delegates to client.bulkMarkRead().
case 'bulk_mark_read': { const { emailIds, read = true } = args as any; if (!emailIds || !Array.isArray(emailIds) || emailIds.length === 0) { throw new McpError(ErrorCode.InvalidParams, 'emailIds array is required and must not be empty'); } const client = initializeClient(); await client.bulkMarkRead(emailIds, read); return { content: [ { type: 'text', text: `${emailIds.length} emails ${read ? 'marked as read' : 'marked as unread'} successfully`, }, ], }; } - src/jmap-client.ts:1387-1413 (helper)Actual JMAP API implementation of bulkMarkRead in JmapClient. Builds a batch update patch for all emailIds setting keywords/$seen to true or null, sends a single Email/set request, and checks for errors.
async bulkMarkRead(emailIds: string[], read: boolean = true): Promise<void> { const session = await this.getSession(); const updates: Record<string, any> = {}; emailIds.forEach(id => { updates[id] = read ? { 'keywords/$seen': true } : { 'keywords/$seen': null }; }); const request: JmapRequest = { using: ['urn:ietf:params:jmap:core', 'urn:ietf:params:jmap:mail'], methodCalls: [ ['Email/set', { accountId: session.accountId, update: updates }, 'bulkUpdate'] ] }; const response = await this.makeRequest(request); const result = this.getMethodResult(response, 0); if (result.notUpdated && Object.keys(result.notUpdated).length > 0) { throw new Error('Failed to update some emails.'); } }