How can we help you?

Getting Started

Keepra runs in your browser, as a Windows desktop app, or on Android. No account is needed for the core features, just open the app and start adding your data.

1. Open the appGo to app.html in your browser, or download the desktop app. Keepra opens on the Dashboard.
2. Add your first linkClick Links in the sidebar → + Add Link. Paste a URL, give it a title and category, then save.
3. Set up the VaultClick Vault → set a master password when prompted. All credentials you add are AES-256-GCM encrypted with this password.
4. Enable cloud sync (optional)Open Settings → Sync & Devices → create a Secret Key or scan a QR from another device.
5. Connect your AI (optional)Open MCP Connector in the sidebar → create a key → follow the setup guide for Claude, Cursor or ChatGPT below.

Tools & Features

Keyboard Shortcuts

MCP Connector Overview

The MCP (Model Context Protocol) Connector lets AI assistants (Claude, ChatGPT, Cursor, and any MCP-compatible client) interact with your Keepra data through 14 secure tools.

The MCP server runs on your machine only: binding to 127.0.0.1:47615. No data leaves your computer. Each AI key has its own scope: you choose exactly what the AI can read or write.

How to create an MCP key

1. Open the desktop appThe MCP server only runs in the Electron desktop app (not the web version).
2. Go to MCP ConnectorClick MCP Connector in the sidebar (or press Ctrl+8).
3. Create a new keyClick + New Key: set a label and select which tools to allow (tasks read/write, notes read, etc.).
4. Copy the keyYour key starts with kp_. Copy it, it won't be shown again.

Setting Up with Claude Desktop

Open Claude Desktop → Settings → Developer → Edit Config, then add the Keepra server:

"mcpServers": {
  "keepra": {
    "command": "node",
    "args": ["C:\\Keepra\\keepra-mcp.js"],
    "env": {
      "KEEPRA_KEY": "kp_your_key_here",
      "KEEPRA_URL": "http://127.0.0.1:47615"
    }
  }
}

Save and restart Claude Desktop. Keepra tools will appear in the tool selector.

Claude Code (CLI)

Open ~/.claude/settings.json and add under "mcpServers":

"keepra": {
  "command": "node",
  "args": ["C:\\Keepra\\keepra-mcp.js"],
  "env": {
    "KEEPRA_KEY": "kp_your_key_here",
    "KEEPRA_URL": "http://127.0.0.1:47615"
  }
}

Save the file — Claude Code picks it up automatically on next session.

Setting Up with Claude.ai (Web App)

Claude.ai uses Remote MCP — unlike Claude Desktop, it cannot run local Node.js processes. Keepra includes an HTTP bridge server (keepra-mcp-http.js) and a free Cloudflare tunnel gives it a public HTTPS URL.

1. Create an MCP keyOpen Keepra → AI section → New Key. Name it "Claude.ai", choose scopes, copy the key.
2. Start the HTTP bridgeOpen a terminal and run:
   node C:\Keepra\keepra-mcp-http.js
   You should see "Keepra MCP HTTP server listening on port 3000".
3. Create a public HTTPS tunnelOpen a second terminal and run (no account needed, completely free):
   npx cloudflared tunnel --url http://localhost:3000
   Copy the https://abc123.trycloudflare.com URL it prints.
4. Add to Claude.aiGo to claude.ai → Profile → Integrations → Add custom integration.
   Server URL: your tunnel URL (e.g. https://abc123.trycloudflare.com)
   Add auth header: Authorization: Bearer kp_YOUR_KEY
5. Test itIn Claude.ai, type: "List my Keepra tasks"

Permanent tunnel (optional)

The free Cloudflare tunnel gives a different URL each time you restart it. For a permanent URL: sign up at cloudflare.com (free account), install cloudflared, and create a named tunnel. Update Claude.ai with the permanent URL once.

Always-on deployment (optional)

You can deploy keepra-mcp-http.js to a free cloud host (Railway, Render, Fly.io) and point its KEEPRA_URL env var at your desktop's permanent tunnel URL. This way Claude.ai always works even when you switch machines.

Setting Up with Cursor

Open Cursor → Settings → MCP → Add Server:

{
  "mcpServers": {
    "keepra": {
      "command": "node",
      "args": ["C:\\Keepra\\keepra-mcp.js"],
      "env": {
        "KEEPRA_KEY": "kp_your_key",
        "KEEPRA_URL": "http://127.0.0.1:47615"
      }
    }
  }
}

MCP Tool Reference

Frequently Asked Questions