Limitless MCP Integration

This repository provides a minimal MCP server/client implementation for interacting with the Limitless Developer API (GET endpoint only). It demonstrates how to expose API endpoints as MCP tools and how to call them via a client using a single merged codebase.

Features

• MCP Server: Exposes a GET endpoint:

  • getLifelogs: List lifelogs with optional query parameters.

• MCP Client: Connects to the server and calls the tools.

• Interactive Mode: Allows calling any tool with JSON parameters.

• Passes environment variables (including API key) to the spawned server.

Prerequisites

• Node.js v20 or higher (with native fetch support or a polyfill)

• npm

• A valid Limitless API key

Setup

1. Clone the repository and navigate into it.

2. Install dependencies:

npm ci

3. Export your API key:

export LIMITLESS_API_KEY=your_api_key_here

Build

Compile the TypeScript code:

npm run build

Usage

The merged implementation supports three modes:

• Server Mode: Runs the MCP server.

node build/index.js server

• Client Mode: Spawns the server and calls the getLifelogs tool.

node build/index.js client

• Interactive Mode: Launches an interactive client to call tools with JSON parameters.

node build/index.js interactive

References

• Limitless Developer API Documentation

• Limitless API Examples on GitHub

License

This project is licensed under the MIT License.