Skip to content

mudassir-awan/keepra

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Keepra

Open Web App  •  Download for Windows or Android  •  Report a Bug

Version Platform Beta MCP License


Keepra keeps your digital life in one private window. It bundles six everyday tools - a link manager, an AES-256 encrypted vault, a notepad, a task manager, a contacts directory, and a file drive - tied together by a unified dashboard. On top of that sits its standout MCP feature: scoped, revocable, local-only access that lets the AI assistant you already use (Claude, ChatGPT, Cursor, Windsurf, or any MCP-compatible client) work with your data.

Everything is stored and encrypted on your device and works fully offline. Cloud sync is optional and zero-knowledge - the server only ever sees ciphertext. No account is required to start; one Secret Key links all your devices.

Screenshots

Keepra Dashboard on Windows
Windows - Dashboard
Keepra Dashboard on Android
Android - Dashboard

See the full visual guide with screenshots of every section for the Dashboard, Vault, Notes, Tasks, Contacts and MCP Connector.

What's inside

Tool What it does
🏠 Dashboard Your home view - stat tiles plus My Day, Recent Links, Pinned items, and Recent Notes. A read-only snapshot that pulls everything together.
🔗 Links Save and one-click-open any URL - Zoom, Meet, and Teams meeting links, work tools, anything. Organize with categories, tags, pinning, and grid or list views.
🔐 Vault A zero-knowledge store for passwords, API keys, SSH keys, database credentials, cards, and secure notes. Encrypted with AES-256-GCM; your master password never leaves your device.
📝 Notes A distraction-free notepad with live preview, split view, tags, and auto-save. Works fully offline.
✅ Tasks A focused task manager with My Day, Important, and Planned smart lists, custom lists, subtasks, priorities, due dates, and recurring tasks.
👥 Contacts A personal people directory. Each contact holds unlimited phone numbers, emails, and links, each with its own custom label.
📁 Drive 50 MB of encrypted file storage for images, PDFs, and archives. Files live in IndexedDB on-device and sync as ciphertext - never plaintext.
🤖 MCP Connector Give Claude, ChatGPT, Cursor, Windsurf, or any MCP client scoped, local-only access to your tasks, notes, links, and contacts - with optional per-item access to individual vault entries. Keys are device-local and never touch the cloud.

Download

Platform Where to get it Notes
Web (PWA) keepra.tech/app.html Runs in any browser. Install to your home screen for offline use.
Windows Download .exe Electron desktop app. Windows 10 and above.
Android Download .apk Direct APK. Play Store listing coming soon.
iOS / macOS Coming soon -

The installers are not yet code-signed, so Windows SmartScreen ("Windows protected your PC") and Android ("this file may harm your device") will warn you on first run. Choose More info → Run anyway / Download anyway - it's safe. See docs/INSTALL.md for step-by-step help.

All features are free during the public beta, and you can use the app locally with no account at all.

How the encryption works

Every item in the Vault is encrypted with AES-256-GCM. The key is derived from your master password using PBKDF2 (SHA-256, 600,000 iterations). Your password is never stored anywhere - not on a server, not even on your own device. It exists only in memory while the app is open.

When you turn on cloud sync, Keepra derives both a Firebase account and an encryption key from a single Secret Key that only you hold. The server receives nothing but base64-encoded ciphertext, so neither Keepra, nor Firebase, nor anyone else can read your data without that key.

Sync across devices

  1. Open Settings → Sync & Devices
  2. Create a vault to generate your Secret Key
  3. On another device, enter the same Secret Key - or scan the QR code shown on the first device

That's it. No email, no separate password, no registration.

Connect your AI assistant (MCP)

Keepra ships an MCP server so the AI you already use can read and write your tasks, notes, links, and contacts - safely and on your terms. It works with Claude (Desktop & Code), ChatGPT, Cursor, Windsurf, and any MCP-compatible client. Each connection uses a scoped API key you create inside the app, and you decide exactly which tools (and which individual vault items) the AI may touch. Keys are device-local and revocable at any time.

Prerequisites: the Keepra desktop app running, plus Node.js.

Easiest - one line (Claude Code):

claude mcp add keepra --env KEEPRA_KEY=YOUR_KEY_HERE -- npx -y keepra-mcp

Any other client (Claude Desktop, Cursor, Windsurf, ChatGPT): add this to its MCP config - no install or file paths, npx fetches the published keepra-mcp server:

{
  "mcpServers": {
    "keepra": {
      "command": "npx",
      "args": ["-y", "keepra-mcp"],
      "env": {
        "KEEPRA_KEY": "YOUR_KEY_HERE",
        "KEEPRA_URL": "http://127.0.0.1:47615"
      }
    }
  }
}

Replace YOUR_KEY_HERE with a key you create in Keepra → Settings → MCP → MCP Integration (a guided, copy-paste walkthrough).

Full multi-client guide (Claude Desktop, Claude Code, ChatGPT, Cursor, Windsurf, and others): docs/MCP-SETUP.md

Frequently asked questions

Is Keepra free? Yes - every feature is free during the public beta (2026). Paid plans are planned for around Q4 2026, and beta users get a promo code that locks in early-adopter pricing.

Does Keepra send my data to a server? No. Your data lives on your device. If you enable sync, only encrypted ciphertext is stored in Firestore - the server never sees plaintext.

Can I use Keepra without an account? Yes. Local use needs no account at all. Sync needs only a Secret Key - no email, no password.

Which AI assistants can connect? Any assistant that speaks the Model Context Protocol - including Claude (Desktop and Code), ChatGPT, Cursor, and Windsurf. You stay in control of exactly what each one can access.

What platforms are supported? Web (any browser, installable as a PWA), Windows 10 and above, and Android. iOS and macOS are planned.

Is the source code open? No - the app is proprietary. This repository is the public community hub for bug reports, feature requests, and documentation.

What encryption does Keepra use? AES-256-GCM for data at rest, with keys derived via PBKDF2 (SHA-256, 600,000 iterations). The master key is never stored.

Roadmap

Feature Status
Web PWA Done
Windows desktop (Electron) Done
Android APK Done
MCP integration (Claude, ChatGPT, Cursor, Windsurf, …) Done
Zero-knowledge cross-device sync Done
QR-code device linking Done
Automatic update notifications Done
Play Store listing In progress
Code-signed installers Planned
macOS and iOS Planned
Biometric unlock Planned
Paid plans Q4 2026

Full roadmap: docs/ROADMAP.md

For developers

Keepra is a single-page app with no build step - plain HTML, CSS, and vanilla JavaScript with jQuery.

  • app.html - unified shell with all the tools
  • app-logic.js - all application logic (vanilla JS + jQuery)
  • app.css - design system with CSS variables and dark/light themes
  • sync.js - zero-knowledge cloud sync (Firebase)
  • keepra-mcp.js - MCP stdio server for AI-client integration
  • electron.js - Electron wrapper with an embedded HTTP server

The same codebase ships to three targets. Web: serve app.html over HTTP. Desktop: Electron copies the files to C:\Keepra\ and serves them over http://localhost. Android: Capacitor wraps the HTML and JS into a native APK.

Architecture detail: docs/ARCHITECTURE.md

Issues and feedback

This repository is the public community hub. The app itself is proprietary.

Security

For security vulnerabilities, please email support@keepra.tech rather than opening a public issue.

See SECURITY.md for the full policy and encryption model.

License

Keepra is proprietary software, free for personal use. See LICENSE.

© 2026 Keepra / IBRANICS - keepra.tech

About

Keepra - private, offline-first productivity app. Links, Vault, Notes, Tasks, Contacts, Drive. AES-256 encrypted. MCP integration for Claude, Cursor, Windsurf.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors