limitless-mcp-server

This repository offers a minimal MCP server/client implementation for the Limitless Developer API, demonstrating how to expose and call API endpoints as MCP tools within a single codebase.

10
0

Limitless MCP Integration

This repository offers a streamlined MCP server/client implementation designed for interacting with the Limitless Developer API (specifically the GET endpoint). It showcases how to present API endpoints as MCP tools and invoke them through a client, all within a unified codebase.

Features

  • MCP Server: Provides a GET endpoint:
    • getLifelogs: Retrieves lifelogs, supporting optional query parameters.
  • MCP Client: Establishes a connection with the server and executes the defined tools.
  • Interactive Mode: Enables dynamic tool invocation using JSON parameters.
  • Propagates environment variables, including the API key, to the initiated server process.

Prerequisites

  • Node.js v20+ (with native fetch or a polyfill)
  • npm
  • A valid Limitless API key

Build

Compile the TypeScript code using npm run build.

Usage

The implementation supports three modes:

  • Server Mode: Executes the MCP server using node build/index.js server.
  • Client Mode: Starts the server and invokes the getLifelogs tool using node build/index.js client.
  • Interactive Mode: Initiates an interactive client for calling tools with JSON parameters using node build/index.js interactive.

References

License

This project is licensed under the MIT License.

Repository

MA
manueltarouca

manueltarouca/limitless-mcp-server

Created

March 15, 2025

Updated

March 22, 2025

Language

TypeScript

Category

Developer Tools