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
- Get your API key from limitless.ai/developers
- Clone and build:
git clone https://github.com/ericbuess/limitless-ai-mcp-server.git
cd limitless-ai-mcp-server
npm install
npm run build
- Configure Claude Code:
claude mcp add limitless -s user -e LIMITLESS_API_KEY="your-key" -- node $(pwd)/dist/index.js
- Start chatting: "Show me my recordings from today"
🚀 Installation
Option 1: Install from npm
npm install -g limitless-ai-mcp-server
Option 2: Install from Source
# Clone the repository
git clone https://github.com/ericbuess/limitless-ai-mcp-server.git
cd limitless-ai-mcp-server
# Install dependencies
npm install
# Build the project
npm run build
# Optional: Link globally
npm link
🔧 Configuration
1. Set up your Limitless API key
# Add to your shell profile (.bashrc, .zshrc, etc.)
export LIMITLESS_API_KEY="your-api-key-here"
# Optional: Configure custom settings
export LIMITLESS_TIMEOUT=120000 # Timeout in milliseconds
export LIMITLESS_BASE_URL="https://api.limitless.ai/v1" # Custom API endpoint
export LOG_LEVEL="INFO" # Options: DEBUG, INFO, WARN, ERROR
# Optional: Configure caching
export CACHE_MAX_SIZE=100 # Maximum cached items
export CACHE_TTL=300000 # Cache lifetime in ms (5 minutes)
export SEARCH_CACHE_MAX_SIZE=50 # Search cache size
export SEARCH_CACHE_TTL=180000 # Search cache lifetime (3 minutes)
2. Configure your MCP client
Claude Code CLI
If you're using Claude Code (Anthropic's official CLI), run:
#
... [View full README on GitHub](https://github.com/ericbuess/limitless-ai-mcp-server#readme)
