199bio-mcp-limitless-server

Limitless MCP Server - Enhanced

Overview

A model context protocol (MCP) server that provides advanced analysis of conversations from Limitless Pendant recordings, with intelligent meeting detection, action item extraction, and comprehensive analytics.

What's New in v0.13.0

• Complete Pagination Support: ALL tools now properly handle large datasets with pagination
• Removed Legacy Features: Cleaned up speech vitality tools to focus on core functionality
• Fixed Remaining Tools: Meeting detection, action items, transcripts, and detailed analysis all use pagination
• Improved Performance: Consistent 10-item API limit across all tools for optimal performance

Previous Updates (v0.12.0)

• Enhanced Token Limit Handling: More aggressive truncation for oversized responses
• Fixed Search Tool: limitless_search_lifelogs now properly handles token limits
• Improved Response Safety: Pre-emptive array truncation before token estimation
• Better Error Prevention: All tools now use safe response wrapper consistently

Previous Updates (v0.11.0)

• Token Limit Solution: Smart pagination and response chunking to handle large datasets
• New Full Transcript Tool: limitless_get_full_transcript fetches complete data with automatic pagination
• Enhanced Pagination: All list tools now support cursor-based pagination to avoid token limits
• Intelligent Response Handling: Automatic detection and handling of oversized responses
• Multiple Output Formats: Summary, full data, or transcript-only modes for flexibility

Previous Updates (v0.9.0)

• Starred Lifelog Support: Filter and identify important conversations marked with stars
• Enhanced Error Messages: More specific error handling with detailed context
• Improved Timezone Handling: Robust fallback mechanism for timezone detection
• Updated Timestamps: Track when lifelogs were last modified with updatedAt field
• Full API Parity: Now supports 100% of official Limitless API parameters

Key Features

• Intelligent Meeting Detection: Automatically identifies meetings from conversations
• Action Item Extraction: Finds tasks and commitments with context
• Natural Language Time Queries: Use expressions like "yesterday", "last week"
• Advanced Search: Find conversations across all history with relevance scoring
• Daily Summaries: Comprehensive analysis with participants and key topics
• Speaker Analytics: Detailed analysis of conversations with specific people
• Smart Pagination: Handles large datasets without token limit issues
• Raw Transcript Access: Get exact transcripts for further AI processing

Installation

npm install -g 199bio-mcp-limitless-server

Usage

Claude Desktop Configuration

Add to your Claude Desktop MCP settings:

{
  "mcpServers": {
    "limitless": {
      "command": "npx",
      "args": ["199bio-mcp-limitless-server"],
      "env": {
        "LIMITLESS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

Advanced Analysis Tools

• Natural Time Queries: limitless_get_by_natural_time
• Meeting Detection: limitless_detect_meetings
• Action Item Extraction: limitless_extract_action_items
• Detailed Transcripts: limitless_get_raw_transcript
• Daily Summaries: limitless_get_daily_summary
• Full Transcript Fetcher: limitless_get_full_transcript (NEW in v0.11.0)

Handling Large Datasets (v0.11.0)

The MCP server now intelligently handles large datasets that would exceed Claude's token limits:

Pagination Support

All list tools now support cursor-based pagination:

# First request
limitless_list_lifelogs_by_date(date="2025-07-24", limit=10)
# Returns: 10 items + cursor

# Next page
limitless_list_lifelogs_by_date(date="2025-07-24", limit=10, cursor="next_page_cursor")

Full Transcript Tool

For complete data without manual pagination:

limitless_get_full_transcript(date="2025-07-24", format="transcript_only")

Formats available:

• summary: Key information only (default)
• full: Complete data including all fields
• transcript_only: Just the transcript text

API Reference

Core Types

interface Lifelog {
  id: string;
  title?: string;
  markdown?: string;
  startTime: string;
  endTime: string;
  contents?: LifelogContentNode[];
  isStarred?: boolean;  // NEW: Whether this lifelog is starred
  updatedAt?: string;   // NEW: When this lifelog was last updated
}

interface LifelogParams {
  // ... existing params ...
  isStarred?: boolean;  // NEW: Filter for starred lifelogs only
  batch_size?: number;  // NEW: Configurable batch size for performance tuning
}

Development

Building from Source

git clone https://github.com/199-biotechnologies/mcp-limitless-enhanced.git
cd mcp-limitless-enhanced
npm install
npm run build

Testing

# Test with real API data
LIMITLESS_API_KEY=your-key npm run dev

Contributing

We welcome contributions that improve the functionality and reliability of this MCP server.

License

MIT License - see LICENSE file for details.

Troubleshooting

Common Issues

"Claude hit max length" message

This message comes from Claude Desktop's UI when responses are too long or the conversation context is filling up. It's NOT related to:

• The MCP server functionality
• Your Claude account tier (free/paid)
• Limitless API limits

Solution: Start a new conversation or ask for shorter responses.

Server crashes with "Unexpected end of JSON input"

This happens when non-JSON data is sent to the server. MCP servers use JSON-RPC over stdio, not HTTP.

Common mistake: Trying to connect with HTTP clients, browsers, or curl. Solution: Use Claude Desktop or a proper MCP client.

Cannot connect via HTTP/Browser/ngrok

MCP servers are NOT HTTP servers. They communicate via JSON-RPC over stdin/stdout.

Wrong: curl http://localhost:8008 Right: Configure in Claude Desktop's MCP settings

No data returned from queries

As of March 2025, the Limitless API primarily surfaces data from the Limitless Pendant. Ensure:

• Your Pendant is actively recording
• You have recent conversation data
• Your API key has proper permissions

Understanding MCP Servers

What MCP servers ARE:

• JSON-RPC services that communicate over stdio
• Designed for Claude Desktop and MCP-compatible clients
• Tools that extend AI assistant capabilities

What MCP servers are NOT:

• HTTP/REST APIs
• Web servers
• Browser-accessible services
• Standalone applications with UIs

If you need HTTP access to Limitless data:

• Use the Limitless API directly
• Create a separate HTTP wrapper service
• Use the official Limitless web interface

Support

• Issues: GitHub Issues
• Documentation: Scientific Documentation
• Contact: [e-mail]