# Install globally
npm install -g @utlyze/limitless-mcp-server

# Or use directly with npx (recommended)
npx @utlyze/limitless-mcp-server

Add to your AI assistant config:

{
  "mcpServers": {
    "limitless": {
      "command": "npx",
      "args": ["-y", "@utlyze/limitless-mcp-server"],
      "env": {
        "LIMITLESS_API_KEY": "your-api-key"
      }
    }
  }
}

Global Installation (Recommended)

npm install -g @utlyze/limitless-mcp-server

Local Project Installation

npm install @utlyze/limitless-mcp-server

Direct Usage (No Installation)

npx @utlyze/limitless-mcp-server

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:

{
  "mcpServers": {
    "limitless": {
      "command": "npx",
      "args": ["-y", "@utlyze/limitless-mcp-server"],
      "env": {
        "LIMITLESS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "limitless": {
      "command": "npx",
      "args": ["-y", "@utlyze/limitless-mcp-server"],
      "env": {
        "LIMITLESS_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Environment Variables

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

Basic Queries

"Show me all my memories from yesterday"
"What did I discuss in meetings today?"
"Find conversations about the product launch"
"Get my daily summary for Monday"

Advanced Searches

"Search for discussions about AI in the last week"
"Show me starred memories from December"
"Export all my meeting notes from this month"
"What action items came up in yesterday's standup?"

AI Questions

"What did John say about the budget proposal?"
"When did I last talk about vacation plans?"
"Summarize my conversations about the new feature"
"What decisions were made in the leadership meeting?"

Organization

"Star the memory about the product roadmap"
"Export this week's meetings as markdown"
"Show me all my Pendant recordings from home"

Technology Stack

• Language: TypeScript
• MCP SDK: @modelcontextprotocol/sdk
• HTTP Client: Axios
• Validation: Zod
• Node Version: 16+

Project Structure

src/
├── config/          # Configuration management
├── lib/             # Core libraries
│   ├── limitless-client.ts
│   └── logger.ts
├── tools/           # MCP tool implementations
│   └── lifelogs/    # Lifelog-related tools
└── types/           # TypeScript type definitions

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

Setup

# Clone the repository
git clone https://github.com/Utlyze/limitless-mcp-server.git
cd limitless-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Run tests
npm test

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

# Run all tests
npm test

# Run with coverage
npm run test:coverage

# Run specific test suite
npm run test:unit
npm run test:integration

Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

• 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

"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