mcp-server-lobstermail

Instructions

Implementation Reference

• src/index.ts:242-257 (handler)

  The handler function that executes the search_emails tool by calling the LobsterMail client's searchEmails method.

  }, async ({ query, inbox_id, from, direction, since, until, has_attachments, limit }) => {
    const lm = await getClient();
    const results = await lm.searchEmails({
      q: query,
      inboxId: inbox_id,
      from,
      direction,
      since,
      until,
      hasAttachments: has_attachments,
      limit,
    });
  
    if (results.data.length === 0) {
      return {
        content: [{ type: 'text' as const, text: `No emails found matching "${query}".` }],

• src/index.ts:226-241 (registration)

  Registration and schema definition for the search_emails tool.

  server.registerTool('search_emails', {
    title: 'Search Emails',
    description:
      'Search emails across all inboxes by keyword. ' +
      'Matches against subject, sender address, and body preview. ' +
      'Optionally scope to a single inbox or filter by sender, direction, date, or attachments.',
    inputSchema: {
      query: z.string().describe('Search query (e.g. "invoice", "verification code")'),
      inbox_id: z.string().optional().describe('Scope search to a specific inbox ID'),
      from: z.string().optional().describe('Filter by sender address (partial match)'),
      direction: z.enum(['inbound', 'outbound']).optional().describe('Filter by email direction'),
      since: z.string().optional().describe('Only emails after this ISO 8601 date'),
      until: z.string().optional().describe('Only emails before this ISO 8601 date'),
      has_attachments: z.boolean().optional().describe('Filter by attachment presence'),
      limit: z.number().optional().describe('Max results (1-50, default 20)'),
    },