Limitless MCP Integration

by manueltarouca

14 173 downloads Not rated yet MIT
GitHub

About

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

Details

License
MIT

Explore

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

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

- Node.js v20 or higher (with native fetch support or a polyfill)
- npm
- A valid Limitless API key

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"
        ]
    }
}

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.