Personal

This MCP server organizes personal information by topic, supports encryption and OTP-based access, and handles data safely with automatic backups. You can manage tasks, meetings, contacts, and more in a flexible, category-driven structure while keeping sensitive data protected.

How to use

You interact with the Personal MCP Server through an MCP client that reads a configuration of local servers you run on your machine. You define one or more local MCP processes that expose data management commands, then use your client to save, retrieve, update, or delete items by topic. Security options let you enable encryption and OTP authentication for sensitive data, and backups help protect you from accidental changes.

How to install

Prerequisites: ensure you have Node.js installed on your system. A common setup uses Node to run MCP servers locally.

Install dependencies and build the project, then prepare a configuration that launches the MCP servers.

npm install
npm run build

Configuration and usage notes

You can run a personal MCP setup by configuring one or more local servers that you start with Node. The configuration below shows two local servers you can run under your own environment. The first exposes the personal information management for a personal context, and the second provides a shared memory variant with a data directory override.

{
  "mcpServers": {
    "personal_info": {
      "command": "node",
      "args": [
        "<path/to/personal-mcp>/dist/index.js"
      ]
    },
    "shared_memory_info": {
      "command": "node",
      "args": [
        "<path/to/personal-mcp>/dist/index.js"
      ],
      "env": {
        "PERSONAL_INFO_DATA_DIR": "<path/to/shared/folder>/shared-mcp-memory"
      }
    }
  }
}

Security and backup basics

Security options include an optional AES-256 encryption layer for file contents and OTP-based access control. You can enable OTP, verify tokens before accessing encrypted data, and lock or disable OTP as needed. A backup system automatically saves data before modifications.

Environment variables you may configure include storage path, file size limits, and backup settings.

Topic-based organization and file format

Information is organized into topics (categories) such as tasks, meetings, contact, personal, health, etc. Each topic contains markdown files with YAML frontmatter that tracks metadata such as category, created/updated timestamps, and tags.

Example structure and file format illustrate how content is stored under data/ with subfolders for each topic, and how YAML frontmatter is used to describe metadata.

Notes on tools and capabilities

You can list, update, delete, and batch fetch or save personal information by topic. Security tools include setup_otp, verify_otp, otp_status, lock_otp, and disable_otp to manage authentication and encryption.

Available tools

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

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