Labsco
h3ro-dev logo

Limitless MCP Server

★ 1

from h3ro-dev

Connect AI assistants to Limitless to access personal memory and lifelog data.

🔥🔥🔥✓ VerifiedAccount requiredAdvanced setup
#email#slack#git#security

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.

<details> <summary>🚀 Quick Start (2 minutes)</summary> 
# 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"
      }
    }
  }
}
</details>

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

Available Tools

<details> <summary>🛠️ Tool Reference</summary>

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
</details>

Architecture

<details> <summary>🏗️ Technical Details</summary>

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
</details>

Development

<details> <summary>👩‍💻 Development Guide</summary>

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
</details>

Support