mcp-limitless

Limitless MCP Server for Cloudflare Workers exposes Claude-compatible tools to search, retrieve, and analyze your Limitless lifelogs. After you deploy and connect Claude to the custom worker connector, Claude will present tools scoped under the Limitless namespace, such as Limitless Ai:search_lifelogs to perform semantic or keyword searches across your lifelog transcripts, Limitless Ai:get_lifelog to fetch a full lifelog entry by ID (including transcript and summaries), and Limitless Ai:list_recent_lifelogs to browse recent recordings with optional date/pagination filters. The server uses GitHub OAuth for secure access and stores OAuth tokens in Cloudflare KV, enabling a seamless, private integration with your Limitless data. The setup emphasizes security and edge performance by deploying on Cloudflare Workers and keeping credentials private.

Once connected, you can query Claude with natural-language prompts like "show meetings about the new project" or "list my recent lifelog transcripts from last week". You can also fetch a specific lifelog to review transcripts, summaries, and associated metadata. The integration is designed for private personal use and leverages per-user OAuth identity to ensure that only authorized users can access their own lifelogs.

Prerequisites:

• A Cloudflare account with Workers access
• A Limitless AI account and API key
• A GitHub account for OAuth
• Node.js v18+ installed locally
• Claude Pro/Max/Team/Enterprise subscription

Step-by-step installation:

1. Clone the repository and install dependencies

git clone https://github.com/BurtTheCoder/mcp-limitless.git
cd mcp-limitless
npm install

2. Run the automated setup script

./setup.sh

This creates wrangler.toml, KV namespaces, and a local .dev.vars template for development.

3. Configure API keys locally Edit the .dev.vars file (or set environment variables in your shell) with:

LIMITLESS_API_KEY="your-limitless-api-key"
GITHUB_CLIENT_ID="your-github-client-id"
GITHUB_CLIENT_SECRET="your-github-client-secret"

4. Start the local dev server

npm run dev

The server will be available at http://localhost:8787 and the OAuth flow can be tested at http://localhost:8787/authorize

5. Deploy to Cloudflare Workers

./deploy.sh

This will prompt for secrets securely and deploy to Cloudflare, giving you a URL like: https://limitless-mcp-server.your-account.workers.dev

6. Connect Claude In Claude, add a custom connector using the provided Worker URL with /sse, for example: https://limitless-mcp-server.your-account.workers.dev/sse Then enable the Limitleess tools in Claude and authorize via GitHub when prompted.

Tips and common issues:

• Ensure LIMITLESS_API_KEY and GitHub OAuth credentials are kept secret; do not commit .dev.vars to version control.
• If you encounter OAuth-related errors, verify that the GitHub OAuth App’s callback URL matches your deployed worker URL (including the /github/callback path).
• The OAuth tokens are stored in Cloudflare KV; make sure your KV namespaces are correctly created during setup.
• If you modify environment variables (e.g., enable IP allowlist), rebuild and redeploy to apply changes.
• For troubleshooting, use npx wrangler tail to stream live logs during development.
• The tools in Claude are namespaced as Limitless Ai:<tool_name>; ensure you reference the exact tool name when constructing queries.