Limitless MCP Integration

by manueltarouca

14 stars
173 downloads
Not rated
GitHub

About

A Model Context Protocol server, client and interactive mode for Limitless API

Details

Author
manueltarouca
GitHub stars
14
Downloads
173
Categories
Other

- Exposes a single getLifelogs tool via MCP
- Supports server, client, and interactive modes
- Passes environment variables including API key to server
- Built with TypeScript and requires Node.js v20+
- License: MIT

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Limitless MCP Integration
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install dependencies with npm ci, build with npm run build, and export your Limitless API key as LIMITLESS_API_KEY. Then run the server with node build/index.js server, the client with node build/index.js client, or the interactive mode with node build/index.js interactive.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "limitless mcp integration": {
            "limitless-mcp-server": {
                "command": "node",
                "args": [
                    "build/index.js",
                    "server"
                ]
            }
        }
    }
}

McpServers

{
    "limitless-mcp-server": {
        "command": "node",
        "args": [
            "build/index.js",
            "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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.