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.
- 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
- 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
- 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
- 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
- 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
npm install -g 199bio-mcp-limitless-server
Add to your Claude Desktop MCP settings:
{
"mcpServers": {
"limitless": {
"command": "npx",
"args": ["199bio-mcp-limitless-server"],
"env": {
"LIMITLESS_API_KEY": "your-api-key-here"
}
}
}
}
-
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)
The MCP server now intelligently handles large datasets that would exceed Claude's token limits:
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")
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
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
}
git clone https://github.com/199-biotechnologies/mcp-limitless-enhanced.git
cd mcp-limitless-enhanced
npm install
npm run build
# Test with real API data
LIMITLESS_API_KEY=your-key npm run dev
We welcome contributions that improve the functionality and reliability of this MCP server.
MIT License - see LICENSE file for details.
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.
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.
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
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
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
- Issues: GitHub Issues
- Documentation: Scientific Documentation
- Contact: boris@199longevity.com