Remem

Log your day. Generate reports. Reflect anytime.

Overview

Remem is a local-first MCP (Model Context Protocol) server that captures your daily activities, generates structured reports, and preserves summaries for long-term reflection.

📝 Log — Record your work, decisions, and memos throughout the day
📊 Generate — Create daily reports from your activity logs
💾 Reflect — Review past entries weeks or months later
🔒 Local storage — Everything stored in SQLite

Quick Start

Add Remem to your Claude Desktop configuration:

{
  "mcpServers": {
    "remem": {
      "command": "npx",
      "args": ["-y", "@remem/mcp-server"]
    }
  }
}

📁 Configuration file location

OS	Path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

Features

Feature	Description
Activity Logging	Record work, decisions, memos, and approvals as you go
Smart Reports	Generate daily reports with customizable templates
Long-term Memory	Summaries are preserved indefinitely for future reflection
Auto Cleanup	Detailed logs expire after configurable days (default: 30)
Multi-language	Automatically adapts to your system language (EN/JA)
Privacy First	All data stored locally in `~/.remem/remem.db`

Tools

Remem provides the following MCP tools:

`log`

Record an activity to the database.

Type: work | decision | memo | approval
Content: Description of the activity

`prepare_report`

Gather logs and prepare data for AI to generate a daily report.

`save_summary`

Save the generated report summary to long-term storage.

`get_history`

Retrieve past summaries for reflection (default: last 6 months).

`configure`

Update server settings like retention_days or default_template.

`get_config`

View current server configuration.

How It Works

┌─────────────────────────────────────────────────────────────┐
│                        Your Day                             │
├─────────────────────────────────────────────────────────────┤
│  9:00  "Reviewed PR #123"           → log(work, ...)       │
│ 11:00  "Decided to use Kysely"      → log(decision, ...)   │
│ 15:00  "Approved deployment"        → log(approval, ...)   │
│ 18:00  "Generate today's report"    → prepare_report()     │
│         AI writes report            → save_summary()       │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    ~/.remem/remem.db                        │
├─────────────────────────────────────────────────────────────┤
│  activities (expires after 30 days)                        │
│  daily_summaries (permanent)                               │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                   6 Months Later                            │
├─────────────────────────────────────────────────────────────┤
│  "What did I work on last quarter?"                        │
│  → get_history(months: 6)                                  │
│  → AI summarizes your growth and achievements              │
└─────────────────────────────────────────────────────────────┘

Configuration

Key	Default	Description
`retention_days`	`30`	Days to keep detailed activity logs
`default_template`	(built-in)	Markdown template for daily reports

Configure via the configure tool or edit ~/.remem/remem.db directly.

Development

# Clone the repository
git clone https://github.com/remem-mcp/remem.git
cd remem

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

# Run locally
node build/index.js

Tech Stack

Runtime: Node.js 24+
Language: TypeScript
Database: SQLite (via Kysely + better-sqlite3)
Protocol: MCP SDK
i18n: i18next
Testing: Vitest

Roadmap

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes using Conventional Commits
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Commit Message Format

This project follows Conventional Commits. Please use the following format:

<type>: <description>

[optional body]

Types: feat, fix, docs, style, refactor, test, chore

Examples:

feat: add weekly summary generation
fix: correct date parsing in prepare_report
docs: update installation instructions

License

⬆ Back to Top

@remem/mcp-server

Quick Install