Personal MCP Server

A Model Context Protocol (MCP) server for managing personal information with dynamic topic-based organization, OTP authentication, and encryption support.

Features

• Topic-Based Organization: Files organized by category (tasks, meetings, contact, personal, etc.)
• Dynamic Categories: No predefined restrictions - create any category that fits your needs
• Rich Metadata: Support for subcategories, tags, and timestamps
• Batch Operations: Efficient bulk operations for saving and retrieving data
• Encryption Support: Optional AES-256 encryption for sensitive data
• OTP Authentication: Time-based OTP for secure access to encrypted data
• Backup System: Automatic backups before data modifications

Quick Start

Installation

npm install
npm run build

Basic Usage - Save to .personal-context-data in user home directory

   {
  "mcpServers": {
    "personal-info": {
      "command": "node",
      "args": [
        "/dist/index.js"
      ]
    }
  }
}

Environment Variables

# Data storage
PERSONAL_INFO_DATA_DIR=./data
PERSONAL_INFO_MAX_FILE_SIZE=1048576  # 1MB
PERSONAL_INFO_BACKUP_ENABLED=true
PERSONAL_INFO_BACKUP_DIR=./backups

# Security (optional)
PERSONAL_INFO_ENCRYPTION_ENABLED=false
PERSONAL_INFO_ENCRYPTION_KEY=""

Configuration Example

   {
  "mcpServers": {
    "shared-memory-info": {
      "command": "node",
      "args": [
        "/dist/index.js"
      ]
      "env": {
        "PERSONAL_INFO_DATA_DIR": "/shared-mcp-memory",
      }
    }
  }
}

Available Tools

Core Information Management

• list_available_personal_info: List all available information by category
• update_personal_info: Update existing personal information
• delete_personal_info: Delete specific personal information
• batch_get_personal_info: Retrieve multiple categories at once
• batch_save_personal_info: Save multiple items efficiently

Security & Authentication

• setup_otp: Set up OTP authentication for encryption
• verify_otp: Verify OTP token to access encrypted data
• otp_status: Check current OTP configuration status
• lock_otp: Immediately lock current OTP session and block access
• disable_otp: Disable OTP and encryption

Topic-Based Organization

File Structure example (auto generated)

Information is organized by topic/category in a simple directory structure for example:

data/
├── tasks/
│   ├── project-alpha-planning.md
│   └── meeting-preparation.md
├── contact/
│   ├── phone-personal-mobile.md
│   └── email-work.md
├── meetings/
│   ├── team-standup-2024-01-15.md
│   └── client-review-2024-01-16.md
├── personal/
│   ├── hobbies.md
│   └── preferences.md
└── health/
    └── allergies.md

File Format

Each file uses YAML frontmatter with markdown content:

---