MCP Personal

🚀 Lifelogger

A personal knowledge system with spaced repetition, designed primarily for use with Claude via MCP.

🚀 Quick Start

Lifelogger is a personal knowledge system that enables you to capture and retain knowledge through spaced repetition. It is designed to work primarily with Claude via MCP.

✨ Features

Core Concepts

• Entries: These represent raw knowledge, including facts, notes, concepts, or anything you wish to remember.
• Cards: Flashcards used for spaced - repetition, which can be optionally linked to entries.

Interaction with Claude

You can use Claude as your interface. During your chat, you can ask Claude to save interesting facts, create flashcards, and quiz you on what you've learned. Claude takes care of phrasing the cards and deciding when to create them, while the MCP tools handle database operations and scheduling.

Example Conversation with Claude

You: I just learned that mass extinction events have happened 5 times in Earth's history, and we might be in the 6th one now caused by humans.

Claude: That's a significant fact. Want me to save this and create some flashcards?

You: Yeah, save it and make a card

Claude: [calls log_entry, then create_card] Done! I've saved the entry tagged with "science" and "ecology", and created a card:

• Q: "How many mass extinction events have occurred in Earth's history?"
• A: "5, with a potential 6th currently caused by humans"

Later:

You: Quiz me on something

Claude: [calls get_due_cards] Here's one: How many mass extinction events have occurred in Earth's history?

You: 5, and we're in the 6th

Claude: Correct! How did that feel—easy, good, hard, or did you forget?

You: Good

Claude: [calls record_review with rating = 2] Got it. You'll see this card again in 4 days.

📦 Installation

1. Install

pip install -e .

2. Database

Set up PostgreSQL and configure the connection:

cp .env.example .env
# Edit .env with your DATABASE_URL

Run migrations:

alembic upgrade head

3. Configure Claude

Add to your Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "lifelogger": {
      "command": "python",
      "args": ["-m", "lifelogger.mcp.server"],
      "env": {
        "DATABASE_URL": "postgresql://user:password@localhost:5432/lifelogger"
      }
    }
  }
}

💻 Usage Examples

Web Interface (Optional)

There's also a React frontend for browsing entries/cards and doing reviews outside of Claude.

# Terminal 1 - Backend
export DATABASE_URL="postgresql://..."
uvicorn lifelogger.api.main:app --port 8000

# Terminal 2 - Frontend
cd frontend && npm install && npm run dev

Open http://localhost:5173

📚 Documentation

MCP Tools

Card types

• basic: One - way Q→A
• reversible: Creates two cards (A→B and B→A)
• cloze: Fill - in - the - blank style

Review ratings

The scheduling uses the SM - 2 algorithm, the same algorithm Anki is based on.

🔧 Technical Details

Tech Stack

• Python 3.11+, FastAPI, SQLAlchemy, Alembic
• PostgreSQL
• MCP Python SDK
• React + Vite (frontend)

Project Structure

lifelogger/
├── alembic/              # Database migrations
├── frontend/             # React web UI
├── lifelogger/
│   ├── api/              # FastAPI REST API
│   ├── core/sm2.py       # Spaced repetition algorithm
│   ├── db/               # SQLAlchemy models
│   └── mcp/server.py     # MCP server
└── pyproject.toml