Limitless MCP Server

Instructions

Implementation Reference

• src/server.ts:438-442 (registration)

  MCP tool registration for 'limitless_get_lifelog_by_id', which wraps the getLifelogById function call.

  server.tool( "limitless_get_lifelog_by_id",
      "Retrieves a single lifelog or Pendant recording by its specific ID.",
      GetByIdArgsSchema,
      async (args, _extra) => handleToolApiCall(() => getLifelogById(limitlessApiKey, args.lifelog_id, { includeMarkdown: args.includeMarkdown, includeHeadings: args.includeHeadings }))
  );

• src/limitless-client.ts:304-316 (handler)

  The core handler function that makes the API request to retrieve a single lifelog by its ID from the Limitless API.

  export async function getLifelogById(apiKey: string, lifelogId: string, options: Pick<LifelogParams, 'includeMarkdown' | 'includeHeadings'> = {}): Promise<Lifelog> {
      // Cannot log here reliably for stdio
      // console.error(`[Limitless Client] Requesting lifelog by ID: ${lifelogId}`);
      const params: Record<string, string | number | boolean | undefined> = {
          includeMarkdown: options.includeMarkdown ?? true,
          includeHeadings: options.includeHeadings ?? true,
      };
      const response = await makeApiRequest<SingleLifelogResponse>(apiKey, `v1/lifelogs/${lifelogId}`, params);
      if (!response.data?.lifelog) {
          throw new LimitlessApiError(`Lifelog with ID ${lifelogId} not found`, 404);
      }
      return response.data.lifelog;
  }

• src/server.ts:188-192 (schema)

  Zod schema defining the input arguments for the tool, including the required lifelog_id.

  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."),
  };

• src/limitless-client.ts:35-45 (schema)

  TypeScript interface defining the structure of a Lifelog object returned by the API.

  export interface Lifelog {
      id: string;
      title?: string;
      markdown?: string;
      startTime: string;
      endTime: string;
      contents?: LifelogContentNode[]; // Use specific type
      isStarred?: boolean; // Whether this lifelog is starred
      updatedAt?: string; // When this lifelog was last updated
      // Add other fields from the API response as needed
  }