Limitless MCP Server

Connect AI assistants to your personal memory through Limitless AI's powerful lifelog system. Access your Pendant recordings, meeting notes, and personal insights directly from Claude, Cursor, or any MCP-compatible AI assistant.

Add to your AI assistant config:

What is Limitless?

Limitless is a personal AI that captures and organizes everything you've seen, said, or heard. Using their Pendant device or desktop app, Limitless creates a searchable memory of your life that you can query and learn from.

Features

🧠 Personal Memory Access

• List and search through all your lifelogs

• Get AI-powered summaries of your days

• Ask questions about your past conversations and meetings

📝 Smart Organization

• Star important memories

• Export memories as markdown

• Filter by date, source, or content

🤖 AI Integration

• Natural language search through your memories

• AI-generated daily summaries

• Context-aware answers about your past

Installation

Global Installation (Recommended)

Local Project Installation

Direct Usage (No Installation)

Configuration

1. Get Your API Key

1. Sign up at limitless.ai

2. Pair your Pendant or install the desktop app

3. Go to Web App → Developer → Create API Key

⚠️ Security Note: Never share your API key or commit it to version control.

2. Configure Your AI Assistant

Claude Desktop (macOS)

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

Cursor

Add to .cursor/mcp.json in your project:

3. Environment Variables

Available Tools

limitless_list_lifelogs

List your lifelogs with powerful filtering options.

Parameters:

• timezone - Timezone for date filtering (e.g., "America/New_York")

• date - Filter by specific date (YYYY-MM-DD)

• startTime - Start time filter (HH:MM)

• endTime - End time filter (HH:MM)

• limit - Number of results (max 100)

• isStarred - Show only starred lifelogs

• includeMarkdown - Include full markdown content

• direction - Sort order (asc/desc)

limitless_get_lifelog

Get detailed information about a specific lifelog.

Parameters:

• lifelogId - The ID of the lifelog

• includeMarkdown - Include markdown content

• includeHeadings - Include content structure

limitless_search_lifelogs

Search through your memories using natural language.

Parameters:

• query - Your search query

• dateFrom - Start date for search

• dateTo - End date for search

• source - Filter by source (pendant/desktop/web/mobile)

limitless_get_daily_summary

Get an AI-generated summary of a specific day.

Parameters:

• date - Date to summarize (YYYY-MM-DD)

• timezone - Your timezone

• includeActionItems - Include action items

• includeKeyTopics - Include main topics

limitless_ask_ai

Ask questions about your memories and get AI-powered answers.

Parameters:

• query - Your question

• dateFrom - Context start date

• dateTo - Context end date

• includeContext - Include source references

limitless_star_lifelog

Mark important memories by starring them.

Parameters:

• lifelogId - The lifelog to star/unstar

• isStarred - true to star, false to unstar

limitless_export_markdown

Export your memories as formatted markdown.

Parameters:

• date - Export specific date

• dateFrom/dateTo - Export date range

• includeMetadata - Include timestamps and metadata

• groupByDate - Organize by date

Usage Examples

Basic Queries

Advanced Searches

AI Questions

Organization

Architecture

Technology Stack

• Language: TypeScript

• MCP SDK: @modelcontextprotocol/sdk

• HTTP Client: Axios

• Validation: Zod

• Node Version: 16+

Project Structure

Error Handling

• Comprehensive error messages

• Graceful API failure handling

• Detailed debug logging

• Input validation

Security

• API key validation at startup

• Secure credential handling

• No credential logging

• HTTPS-only communication

Development

Setup

Scripts

• npm run dev - Development mode with hot reload

• npm run build - Build for production

• npm test - Run test suite

• npm run lint - Check code style

• npm run typecheck - Verify TypeScript types

Testing

Contributing

1. Fork the repository

2. Create a feature branch

3. Make your changes

4. Add tests

5. Submit a pull request

API Limitations

• Pendant Only: Currently limited to Pendant recordings (desktop/web coming soon)

• Read Only: No ability to create or modify lifelogs

• Beta API: Some features may change as the API evolves

• Rate Limits: Standard API rate limits apply

Troubleshooting

"API Key Required" Error

• Ensure LIMITLESS_API_KEY is set in your config

• Check that the key is valid and active

• Verify you've created a key at app.limitless.ai

"No Lifelogs Found"

• Ensure you have recordings in your account

• Check the date range you're querying

• Verify your Pendant is syncing properly

Connection Issues

• Check your internet connection

• Verify the API is accessible

• Try the debug mode: DEBUG=true

Tool Not Found

• Restart your AI assistant

• Check the tool name is correct

• Verify MCP server is running

Support

• Documentation: limitless.ai/developers

• Slack Community: Join #developers channel

• GitHub Issues: Report bugs here

• Email: support@limitless.ai

License

MIT License - see LICENSE file for details.

Built with ❤️ for the Limitless community. Remember everything, forget nothing.