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

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

Environment Variables

Configuration Example

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:

File Format

Each file uses YAML frontmatter with markdown content:

Security Features

OTP Authentication

For sensitive data, enable OTP authentication:

1. Setup OTP: Use setup_otp tool to generate QR code and backup codes

2. Verify Access: Use verify_otp tool before accessing encrypted data

3. Check Status: Use otp_status tool to see current authentication state

4. Lock Session: Use lock_otp tool to immediately terminate access when stepping away

Encryption

• AES-256 encryption for file contents

• Stable encryption keys (not time-based)

• OTP used for access control, not key derivation

Development

Building and Testing

License

MIT License - see LICENSE file for details.

Vibe Coding Disclaimer ⚠️

The code is written by AI, so it may not be the best code. Use it at your own risk.