Personal

This MCP Server provides an extensible personal processing environment that integrates with Claude Desktop. It lets you manage tasks, notes, and files, and optionally connect to Google Calendar, all via a straightforward local server you run on your machine.

How to use

You use the MCP server through either the Web Interface or the Claude Desktop integration. The Web Interface gives you a real-time dashboard, task management, note taking, and live logs. The Claude Desktop flow lets you test and interact with the server directly from your desktop client. In both modes, you can issue natural language commands to manage tasks, notes, and files.

How to install

Prerequisites: you need Python installed on your system and a compatible shell/terminal. Follow these steps to set up and run the MCP Server.

# 1. Install Python (if not already installed)
# 2. Set up a virtual environment
python -m venv venv

# 3. Activate the virtual environment
# Windows
venv\Scripts\activate

# macOS/Linux
source venv/bin/activate

# 4. Install required dependencies
pip install -r requirements.txt

Run the Web Interface for quick access to the dashboard and tasks.

start_web_interface.bat

To enable Claude Desktop integration, run the interactive menu and select the option to start the service.

runa_tests.bat

# 1. Run the interactive menu
# 2. Choose [1] to test
# 3. Choose [2] to start
# 4. Open Claude Desktop and test

Configuration

Environment and startup details are shown below. Adjust values to fit your environment.

# .env
# Debug
DEBUG=False

# Directories allowed (comma-separated)
ALLOWED_DIRECTORIES="C:\\projetos\\IA,\\C:\\Users\\PC Gamer\\Documents"

# Logging
LOG_LEVEL=INFO
LOG_FILE=./logs/mcp_server.log

# Tasks
TASKS_DB_PATH=./data/tasks.json

# Google Calendar (optional)
GOOGLE_CLIENT_ID=seu_client_id
GOOGLE_CLIENT_SECRET=seu_secret

Claude Desktop connection example shown as JSON configuration.

{
  "mcpServers": {
    "personal-server": {
      "command": "C:\\projetos\\IA\\mcp\\mcp-tools2\\venv\\Scripts\\python.exe",
      "args": ["C:\\projetos\\IA\\mcp\\mcp-tools2\\main.py"]
    }
  }
}

Troubleshooting

If the server does not start, verify dependencies, run in verbose mode, and check logs.

# Activate environment and install dependencies
venv\Scripts\activate
pip install -r requirements.txt

# Run verbose server to capture detailed output
python main_verbose.py

# View logs
type logs\mcp_server.log

If Claude Desktop does not recognize commands, restart Claude Desktop, verify the configuration path, monitor logs, and run tests.

# Check current config
# Then monitor and test
run_tests.bat → [4]
run_tests.bat → [1]

Notes and examples

Common commands you can use via Claude include creating and listing tasks, writing notes, reading files, and listing directories.

"liste minhas tarefas pendentes"
"crie uma nota sobre MCP Server"
"liste os arquivos em C:\\projetos\\IA"

Additional tips

For routine use, start the server with the provided interactive menu and keep Claude Desktop connected for seamless command execution.

Available tools

Web Interface

Web dashboard with real-time statistics, task management, and live logs accessible at http://localhost:5000.

Claude Desktop Integration

Connects Claude Desktop to the MCP server, enabling natural language interactions and testing from the desktop client.

Test Menu

Interactive menu run_tests.bat for testing, starting, monitoring, and logging.