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: [email protected]

言语活力指数