Memory Journal MCP v3.0.0: TypeScript Rewrite

Solve the AI Context Problem. When working with AI across multiple threads and sessions, context is lost. Memory Journal maintains a persistent, searchable record of your project work, decisions, and progress—making every AI conversation informed by your complete project history.

Memory Journal v3.0.0 is a ground-up TypeScript rewrite delivering a Pure JS Stack with no native dependencies, cross-platform portability, and strict type safety. This release includes new backup/restore tools, a health diagnostics resource, and full MCP 2025-11-25 compliance.

🚀 Complete TypeScript Rewrite

Memory Journal v3.0.0 delivers a ground-up rewrite in TypeScript with:

Pure JS Stack - No native compilation required (sql.js + vectra + @xenova/transformers)
Cross-Platform Portability - Works on Windows, macOS, Linux without binary dependencies
Strict Type Safety - Zero TypeScript errors, 100% strict mode compliance
Faster Startup - Lazy ML loading with instant cold starts
MCP 2025-11-25 Compliance - Full spec compliance with behavioral annotations

🗄️ Backup & Restore Tools

Never lose your journal data. Three new tools for data protection:

backup_journal - Create timestamped database backups
list_backups - List all available backup files
restore_backup - Restore from any backup (with auto-backup before restore)

// Create a backup before major changes
backup_journal({ name: "before_migration" })

// List available backups
list_backups()

// Restore from backup (creates auto-backup first)
restore_backup({ filename: "before_migration.db", confirm: true })

📊 Server Health Resource

Get comprehensive server diagnostics via memory://health:

{
  "database": { "entryCount": 150, "relationshipCount": 42, "tagCount": 28 },
  "backups": { "count": 3, "lastBackup": { "filename": "...", "sizeBytes": 524288 } },
  "vectorIndex": { "available": true, "indexedEntries": 150 },
  "toolFilter": { "enabledCount": 27, "totalCount": 27 }
}

📋 Core Capabilities

27 MCP Tools (8 Groups)

core - Entry CRUD, tags, test
search - Text, date, semantic search
analytics - Statistics, insights
relationships - Links, graphs
export - JSON/Markdown export
admin - Update, delete, rebuild index
github - Issues, PRs, Projects
backup - Backup, list, restore

14 Workflow Prompts

Daily standups & retrospectives
Weekly digests & period analysis
PR summaries & code review prep
Goal tracking & milestones
CI/CD failure analysis
Context bundles for AI

14 MCP Resources

memory://recent - Recent entries
memory://health - Server diagnostics
memory://graph/* - Relationship graphs
memory://projects/* - Project timelines
memory://issues/* - Issue entries
memory://prs/* - PR timelines

Key Features

Semantic vector search
Knowledge graphs with Mermaid
GitHub Projects integration
Team collaboration (Git-based)
Configurable tool filtering
Soft delete & recovery

🚀 Quick Start

Option 1: npm (Recommended)

npm install -g memory-journal-mcp

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "memory-journal-mcp": {
      "command": "memory-journal-mcp"
    }
  }
}

Option 2: npx (No Installation)

{
  "mcpServers": {
    "memory-journal-mcp": {
      "command": "npx",
      "args": ["-y", "memory-journal-mcp"]
    }
  }
}

Option 3: Docker

docker pull writenotenow/memory-journal-mcp:latest

🏗️ Architecture

┌─────────────────────────────────────────────────────────────┐
│ MCP Server Layer (TypeScript)                               │
│  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────┐  │
│  │ Tools (27)      │  │ Resources (14)  │  │ Prompts (14)│  │
│  │ with Annotations│  │ with Annotations│  │             │  │
│  └─────────────────┘  └─────────────────┘  └─────────────┘  │
├─────────────────────────────────────────────────────────────┤
│ Pure JS Stack (No Native Dependencies)                      │
│  ┌─────────────────┐  ┌─────────────────┐  ┌─────────────┐  │
│  │ sql.js          │  │ vectra          │  │ transformers│  │
│  │ (SQLite)        │  │ (Vector Index)  │  │ (Embeddings)│  │
│  └─────────────────┘  └─────────────────┘  └─────────────┘  │
├─────────────────────────────────────────────────────────────┤
│ SQLite Database with Hybrid Search                          │
│  ┌─────────────────────────────────────────────────────────┐│
│  │ entries + tags + relationships + embeddings + backups   ││
│  └─────────────────────────────────────────────────────────┘│
└─────────────────────────────────────────────────────────────┘

📚 Documentation & Resources

GitHub (repository, wiki, changelog) • npm • Docker Hub • MCP Registry

Migrating from v2.x? Your existing database is fully compatible. The TypeScript version uses the same schema and data format.