limitless-mcp-server

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.