Personal Reflection MCP

A FastMCP server for journaling, habit tracking, and task management with SQLite storage.

Features

• Add journal entries

• View all journal entries

• Search journal entries

• View journal statistics

• Generate recent reflections

• Create and track habits

• Mark habits as completed

• View habit statistics

• Create tasks/goals

• Mark tasks as completed

• View all tasks

Related MCP server: mcp-tasks-server

Project Structure

personal_reflection_mcp/
│
├── server.py
├── tools.py
├── journal.py
├── habits.py
├── tasks.py
├── reflection.py
├── stats.py
├── database.py
├── schema.py
├── requirements.txt
├── Dockerfile
├── .gitignore
│
└── data/
    └── reflection.db

Installation

Clone the repository:

git clone https://github.com/Adithi1367/Personal-reflection-mcp.git
cd Personal-reflection-mcp

Create a virtual environment:

python -m venv .venv

Activate it:

Windows

.venv\Scripts\activate

Install dependencies:

pip install -r requirements.txt

Run the MCP Server

fastmcp run server.py

Run with Docker

Build the image:

docker build -t personal-reflection-mcp .

Run the container:

docker run personal-reflection-mcp

Technologies Used

• Python

• FastMCP

• SQLite

• Docker

License

This project is for learning and personal use.