Limitless AI MCP Server

An advanced Model Context Protocol (MCP) server that enables AI assistants to interact with Limitless AI Pendant recordings. This server provides a seamless bridge between your AI tools and Limitless API, allowing you to extract insights, search through recordings, and analyze your Pendant data.

> ⚠️ Beta Release: This is an early release (v0.0.1). While core features are implemented and tested, we need community feedback to validate all functionality. Please report any issues!

🌟 Features

Core Capabilities

- Full Limitless API Integration: Access all your Pendant recordings programmatically
- Advanced Search: Search through your recordings with keyword matching
- Flexible Querying: List recordings by date, date range, or get recent recordings
- Rich Content Access: Retrieve markdown content, headings, and metadata
- High Performance: Intelligent caching with LRU eviction and TTL support
- Robust Error Handling: Built-in retry logic and timeout management
- Type Safety: Full TypeScript support with comprehensive type definitions

MCP Protocol Implementation

- 🔧 Tools: 5 specialized tools for searching and retrieving recordings
- 📁 Resources: Browse recordings as structured resources with URI navigation
- 📝 Prompts: Pre-built templates for common analysis tasks
- 🔍 Sampling: AI-powered content analysis and summarization
- 🔎 Discovery: Automatic capability exposure to MCP clients

📋 Requirements

- Node.js 22+
- Limitless Pendant (Required - API only returns Pendant recordings)
- Limitless API Key (Get from limitless.ai/developers)
- MCP-compatible client (Claude Desktop, Windsurf, Cursor, etc.)

🏃 Quick Start

1. Get your API key from limitless.ai/developers
2. Clone and build:

   git clone https://github.com/ericbuess/limitless-ai-mcp-server.git

   cd limitless-ai-mcp-server

   npm install

   npm run build

   

   claude mcp add limitless -s user -e LIMITLESS_API_KEY="your-key" -- node $(pwd)/dist/index.js

   

🚀 Installation

Option 1: Install from npm

npm install -g limitless-ai-mcp-server

Option 2: Install from Source

```bash