Limitless MCP Server

Instructions

Implementation Reference

• src/server.ts:443-496 (registration)

  Registration of the 'limitless_list_lifelogs_by_date' tool, including the handler function that validates input, fetches paginated lifelogs for a specific date using getLifelogsWithPagination, handles response truncation for token limits, and formats the output with pagination info.
  server.tool( "limitless_list_lifelogs_by_date", "Lists logs/recordings for a specific date. Returns paginated results to avoid token limits. Use cursor to fetch next page. Best for getting raw log data which you can then analyze for summaries, action items, topics, etc.", ListByDateArgsSchema, async (args, _extra) => { try { const validation = validateApiConstraints(args); if (!validation.valid) { return { content: [{ type: "text", text: validation.error! }], isError: true }; } // Use pagination-aware function const result = await getLifelogsWithPagination(limitlessApiKey, { date: args.date, limit: args.limit || MAX_API_LIMIT, timezone: args.timezone, includeMarkdown: args.includeMarkdown, includeHeadings: args.includeHeadings, direction: args.direction ?? 'asc', isStarred: args.isStarred, cursor: args.cursor }); // Check if response might be too large const estimatedSize = estimateTokens(JSON.stringify(result.lifelogs)); if (estimatedSize > MAX_RESPONSE_TOKENS * 0.8 && result.lifelogs.length > 1) { // Return partial data with strong cursor guidance const partialCount = Math.max(1, Math.floor(result.lifelogs.length * 0.5)); const partialLifelogs = result.lifelogs.slice(0, partialCount); return createSafeResponse( partialLifelogs, `Found ${result.lifelogs.length} lifelogs for ${args.date}, showing first ${partialCount} to avoid token limits`, { nextCursor: result.pagination.nextCursor, hasMore: true, totalFetched: partialCount } ); } return createSafeResponse( result.lifelogs, `Found ${result.lifelogs.length} lifelogs for ${args.date}`, { nextCursor: result.pagination.nextCursor, hasMore: result.pagination.hasMore, totalFetched: result.lifelogs.length } ); } catch (error) { return handleToolApiCall(() => Promise.reject(error)); } } );
• src/server.ts:179-196 (schema)

  Zod schemas defining the input parameters for the tool: ListByDateArgsSchema (requires 'date' in YYYY-MM-DD) extending CommonListArgsSchema (limit, cursor, timezone, etc.).
  const CommonListArgsSchema = { limit: z.number().int().positive().max(MAX_API_LIMIT).optional().default(MAX_API_LIMIT).describe(`Maximum number of lifelogs to return per request (Max: ${MAX_API_LIMIT} per API constraint). Use cursor for pagination.`), cursor: z.string().optional().describe("Pagination cursor from previous response. Use to fetch next page of results."), timezone: z.string().optional().describe("IANA timezone for date/time parameters (defaults to server's local timezone)."), includeMarkdown: z.boolean().optional().default(true).describe("Include markdown content in the response."), includeHeadings: z.boolean().optional().default(true).describe("Include headings content in the response."), direction: z.enum(["asc", "desc"]).optional().describe("Sort order ('asc' for oldest first, 'desc' for newest first)."), isStarred: z.boolean().optional().describe("Filter for starred lifelogs only."), }; const GetByIdArgsSchema = { lifelog_id: z.string().describe("The unique identifier of the lifelog to retrieve."), includeMarkdown: z.boolean().optional().default(true).describe("Include markdown content in the response."), includeHeadings: z.boolean().optional().default(true).describe("Include headings content in the response."), }; const ListByDateArgsSchema = { date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Date must be in YYYY-MM-DD format.").describe("The date to retrieve lifelogs for, in YYYY-MM-DD format."), ...CommonListArgsSchema };
• src/limitless-client.ts:267-302 (helper)

  Core helper function getLifelogsWithPagination that makes the API request to Limitless /v1/lifelogs endpoint with parameters including date filter, handles response parsing, and returns lifelogs with pagination metadata. Called directly by the tool handler.
  export async function getLifelogsWithPagination(apiKey: string, options: LifelogParams = {}): Promise<LifelogsWithPagination> { const defaultTimezone = getDefaultTimezone(); const batchSize = options.limit || 10; // Use requested limit as batch size const params: Record<string, string | number | boolean | undefined> = { limit: batchSize, includeMarkdown: options.includeMarkdown ?? true, includeHeadings: options.includeHeadings ?? true, date: options.date, start: options.start, end: options.end, direction: options.direction ?? 'desc', timezone: options.timezone ?? defaultTimezone, cursor: options.cursor, isStarred: options.isStarred, }; // Clean up undefined values Object.keys(params).forEach(key => { if (params[key] === undefined) delete params[key]; }); const response = await makeApiRequest<LifelogsResponse>(apiKey, "v1/lifelogs", params); const lifelogs = response.data?.lifelogs ?? []; const nextCursor = response.meta?.lifelogs?.nextCursor; const count = response.meta?.lifelogs?.count ?? lifelogs.length; return { lifelogs, pagination: { nextCursor, hasMore: !!nextCursor, count } }; }
• src/limitless-client.ts:6-18 (schema)

  TypeScript interface LifelogParams defining the parameters passed to API functions, matching the tool's input schema (used by getLifelogsWithPagination).
  export interface LifelogParams { limit?: number; batch_size?: number; // Used internally for pagination fetching includeMarkdown?: boolean; includeHeadings?: boolean; date?: string; // YYYY-MM-DD start?: string; // YYYY-MM-DD or YYYY-MM-DD HH:mm:SS end?: string; // YYYY-MM-DD or YYYY-MM-DD HH:mm:SS timezone?: string; direction?: "asc" | "desc"; cursor?: string; isStarred?: boolean; // Filter for starred lifelogs only }