limitless-mcp-server

limitless-mcp-server

10
developer_tools

This project offers a basic MCP server/client setup to interact with the Limitless Developer API through GET endpoints. It enables users to expose API endpoints as MCP tools and call them from a client using a unified codebase.

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
  1. 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

License

This project is licensed under the MIT License.