Limitless AI MCP Server
A Model Context Protocol (MCP) server that connects AI assistants to Limitless AI lifelog data. This server enables seamless integration with your recorded conversations, thoughts, and daily activities from your Limitless AI pendant, allowing AI assistants to read, search, and analyze your personal lifelog.
Why This Tool?
Limitless AI creates a continuous lifelog by recording your conversations and activities throughout the day. This MCP server bridges the gap between your lifelog data and AI assistants, enabling:
- Personal Memory Access: Retrieve specific conversations and moments from your lifelog
- Intelligent Search: Find relevant content across your entire recorded history
- Timeline Analysis: Understand patterns and evolution in your daily activities
- Context-Aware Assistance: AI assistants can reference your past conversations and experiences
Features
- Limitless AI Integration: Direct access to your lifelog data via the official API
- Type-Safe Implementation: Written in TypeScript with comprehensive type definitions
- Input Validation: Robust validation for all API inputs using Zod schemas
- Error Handling: Graceful error handling with informative messages
- MCP Integration: Full compatibility with Claude, Cursor, Windsurf, Cline, and other MCP hosts
Available Tools
Lifelog Access
-
getLifelogs: Retrieve lifelog entries with flexible filtering options:
- Filter by date, timezone, and time ranges
- Pagination support for large datasets
- Sort by ascending or descending order
-
getLifelogEntry: Get detailed information about a specific lifelog entry by ID
-
searchLifelogs: Search through your lifelog content:
- Full-text search across summaries and content
- Date range filtering
- Pagination for comprehensive results
Use Cases
For Personal Productivity
- Meeting Follow-up: AI can access your recorded meetings to create action items
- Conversation Context: Reference past discussions for better continuity
- Reflection & Analysis: Understand patterns in your daily interactions
For Knowledge Workers
- Research Assistant: AI can recall relevant conversations and insights
- Decision Support: Reference past discussions when making decisions
- Learning Reinforcement: AI can help you remember key insights from conversations
For Content Creation
- Writing Support: Pull relevant experiences and conversations for storytelling
- Idea Development: Track how concepts have evolved through your conversations
- Personal Documentation: Create summaries and insights from your lifelog data
Installation
Using Smithery (Recommended)
The easiest way to install Limitless AI MCP is using Smithery:
# For Claude Desktop
npx -y @smithery/cli install @Hint-Services/mcp-limitless --client claude
# For Cursor
npx -y @smithery/cli install @Hint-Services/mcp-limitless --client cursor
# For Windsurf
npx -y @smithery/cli install @Hint-Services/mcp-limitless --client windsurf
# For Cline
npx -y @smithery/cli install @Hint-Services/mcp-limitless --client cline
Manual Installation
npm install mcp-limitless
Configuration
Add the server to your MCP settings file with the following configuration:
{
"mcpServers": {
"limitless": {
"command": "npx",
"args": ["-y", "mcp-limitless"],
"env": {
"LIMITLESS_API_KEY": "your-limitless-api-key"
}
}
}
}
Required Environment Variables
LIMITLESS_API_KEY: Your Limitless AI API key (get it here)
Optional Environment Variables
LIMITLESS_BASE_URL: Custom API base URL (defaults tohttps://api.limitless.ai)
Getting Your API Key
- Visit Limitless AI Developer Platform
- Sign in to your Limitless account
- Navigate to Developer settings
- Generate a new API key
- Important: Never share your API key or commit it to source control
Example Workflows
Getting Today's Lifelog Entries
{
"tool": "getLifelogs",
"arguments": {
"date": "2024-01-15",
"timezone": "America/Los_Angeles",
"limit": 10
}
}
Finding Specific Conversations
{
"tool": "searchLifelogs",
"arguments": {
"query": "meeting with Sarah about project planning",
"limit": 5
}
}
Getting Entries from a Date Range
{
"tool": "getLifelogs",
"arguments": {
"date": "2024-01-15",
"start_time": "09:00:00",
"end_time": "17:00:00",
"timezone": "America/New_York"
}
}
Retrieving a Specific Entry
{
"tool": "getLifelogEntry",
"arguments": {
"lifelog_id": "entry_12345"
}
}
Searching Across Multiple Days
{
"tool": "searchLifelogs",
"arguments": {
"query": "quarterly planning",
"date_from": "2024-01-01",
"date_to": "2024-01-31",
"limit": 10
}
}
API Limitations
- The Limitless AI API is currently in beta
- Maximum 10 entries per request
- Only supports Pendant device data currently
- Search functionality is implemented locally (API search coming soon)
Project Structure
mcp-limitless/
├── src/
│ ├── index.ts # Main MCP server entry point
│ └── limitless/ # Limitless AI integration
│ ├── client.ts # Limitless client implementation
│ └── types.ts # TypeScript type definitions
├── docs/ # Documentation
├── package.json # Project configuration
└── tsconfig.json # TypeScript configuration
For Developers
Development Commands
pnpm install- Install dependenciespnpm run build- Build the project for HTTP streaming (default)pnpm run dev- Run in development mode with hot reloadingpnpm run inspector- Launch MCP inspector for testing (stdio mode)pnpm run test- Run tests
Deployment Options
HTTP Streaming (Recommended)
pnpm run build:http
pnpm run start:http
Traditional stdio (Legacy)
pnpm run build:stdio
pnpm run start:stdio
The HTTP streaming interface offers better performance and simplified deployment without requiring Docker, while maintaining full backwards compatibility with the traditional stdio interface.
API Reference
The server implements the following MCP tools:
getLifelogs- Retrieve lifelog entries with filteringgetLifelogEntry- Get specific lifelog entry by IDsearchLifelogs- Search through lifelog content
For detailed API documentation, see the Limitless AI Developer Documentation.
Privacy & Security
- Your API key is used only to authenticate with Limitless AI's official API
- No data is stored or cached by this MCP server
- All communication is directly between your client and Limitless AI's servers
- Follow Limitless AI's privacy policy and terms of service
Troubleshooting
API Key Issues
- Ensure your API key is valid and not expired
- Check that you're using the correct environment variable name:
LIMITLESS_API_KEY - Verify your account has API access enabled
No Data Returned
- Confirm your Limitless pendant is recording data
- Check the date ranges in your queries
- Verify your timezone settings
Connection Issues
- Check your internet connection
- Verify the API base URL is correct
- Ensure Limitless AI services are operational
Learn More
For further information, refer to:
- Limitless AI Developer Documentation: Official API documentation
- Model Context Protocol Documentation: MCP architecture and design principles
- Smithery - MCP Server Registry: Guidelines for publishing MCP servers
- MCP TypeScript SDK Documentation: Comprehensive TypeScript SDK documentation
About Hint Services
"The future is already here, it's just unevenly distributed"
— William Gibson, Author
Hint Services is a boutique consultancy with a mission to develop and expand how user interfaces leverage artificial intelligence technology. We architect ambition at the intersection of AI and User Experience, founded and led by Ben Hofferber.
We offer specialized AI workshops for design teams looking to embrace AI tools without becoming developers. Learn more about our training and workshops.