https://github.com/manueltarouca/limitless-mcp-server
A Model Context Protocol server, client and interactive mode for Limitless API
https://github.com/manueltarouca/limitless-mcp-server
Last synced: 8 months ago
JSON representation
A Model Context Protocol server, client and interactive mode for Limitless API
- Host: GitHub
- URL: https://github.com/manueltarouca/limitless-mcp-server
- Owner: manueltarouca
- License: mit
- Created: 2025-03-15T01:26:08.000Z (8 months ago)
- Default Branch: master
- Last Pushed: 2025-03-15T01:58:50.000Z (8 months ago)
- Last Synced: 2025-03-15T02:36:10.244Z (8 months ago)
- Language: TypeScript
- Size: 14.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **limitless-mcp-server** - A Model Context Protocol server, client and interactive mode for Limitless API `typescript` `server` `api` `npm install manueltarouca/limitless-mcp-server` (🌐 Web Development)
README
# 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:**
```bash
npm ci
```
3. **Export** your API key:
```sh
export LIMITLESS_API_KEY=your_api_key_here
```
## Build
Compile the TypeScript code:
```bash
npm run build
```
## Usage
The merged implementation supports three modes:
- **Server Mode**: Runs the MCP server.
```bash
node build/index.js server
```
- **Client Mode**: Spawns the server and calls the `getLifelogs` tool.
```bash
node build/index.js client
```
- **Interactive Mode**: Launches an interactive client to call tools with JSON parameters.
```bash
node build/index.js interactive
```
## References
- [Limitless Developer API Documentation](https://www.limitless.ai/developers/docs/api)
- [Limitless API Examples on GitHub](https://github.com/limitless-ai-inc/limitless-api-examples)
## License
This project is licensed under the MIT License.