MCP Dayone

🚀 MCP-DayOne

A Model Context Protocol (MCP) server for integrating Day One Journal with Claude Desktop.

🚀 Quick Start

This MCP server allows Claude Desktop to interact with your Day One journal via the Model Context Protocol. Through natural conversations, Claude can create journal entries, list available journals, and obtain entry counts.

✨ Features

✍️ Write Operations (Day One CLI)

• 📝 Create journal entries with rich content and metadata.
• 📎 Attach photos, videos, audio, and PDFs to entries.
• ⭐ Mark entries as starred or important.
• 📍 Add location coordinates to entries.
• 🕐 Enhanced date/time handling with timezone support.

📖 Read Operations (Direct Database Access)

• 📖 NEW: Read recent journal entries with full metadata.
• 🔍 NEW: Search entries by text content.
• 📚 NEW: List actual journals with entry counts and statistics.
• 📊 NEW: Get real entry counts from the database.
• 🏷️ NEW: View entry tags, dates, and metadata.

🔧 Technical

• Proper error handling and validation.
• Direct SQLite database integration for read operations.
• Hybrid approach: CLI for writing, database for reading.
• 🚀 Easy installation with uv.

📦 Installation

⚡ Quick Start (5 minutes)

This MCP server is designed for zero-configuration installation - you only need to change one file path!

1. Install Prerequisites (One-time setup)

Day One CLI Installation:

1. Download and install Day One from the Mac App Store or the Day One website.
2. The Day One CLI is automatically included with the app - no separate installation needed!
3. Verify it's working: dayone2 --version.

Python and uv:

# Install uv package manager (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Verify Day One CLI is accessible
dayone2 --version

2. Clone and Setup (Automatic dependency management)

git clone <repository-url>
cd mcp-dayone
uv sync  # Automatically installs all Python dependencies

3. Validate Installation (Built-in testing)

# Run comprehensive setup validation
uv run python test_setup.py

This test script automatically:

• ✅ Verifies Day One CLI is accessible.
• ✅ Tests database connectivity.
• ✅ Validates MCP server functionality.
• ✅ Lists available tools.
• 🔧 Provides helpful error messages if anything needs fixing.

4. Configure Claude Desktop (Only one path to change!)

Add to your Claude Desktop configuration file:

Config File Location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration (replace path only):

{
  "mcpServers": {
    "dayone": {
      "command": "uv",
      "args": [
        "--directory",
        "/FULL/PATH/TO/mcp-dayone",
        "run",
        "python",
        "-m",
        "mcp_dayone.server"
      ]
    }
  }
}

⚠️ Only change needed: Replace /FULL/PATH/TO/mcp-dayone with your actual repository path.

5. Restart Claude Desktop

After updating the configuration, restart Claude Desktop to load the MCP server.

🎉 What Makes This Easy:

• 🔍 Automatic Detection: Database path, CLI location, and all dependencies are detected automatically.
• 📦 Zero Dependencies: uv sync handles everything - no manual package installation.
• 🧪 Built-in Validation: test_setup.py ensures everything works before you configure Claude.
• 🛠️ No Code Changes: Works out-of-the-box for standard Day One installations.
• 📱 Universal Compatibility: Works with any Day One database and journal setup.
• 🚨 Helpful Errors: Clear guidance if Day One CLI or the database isn't accessible.

🚀 Ready to Use!

Once configured, you can immediately start using natural language commands like:

• "Show me my recent journal entries"
• "What were my journal entries on this day?"
• "Create a journal entry about my day"

No additional setup, configuration files, or environment variables are needed!

💻 Usage Examples

📅 "On This Day" Feature

The MCP server excels at retrieving historical entries for reflection and memory recall:

Query: "Show me all my journal entries for 'on this day,' today: June 14th."

Result: Claude automatically:

1. Uses the get_entries_by_date tool to search June 14th across multiple years.
2. Groups entries by year with "X years ago" labels.
3. Shows detailed content previews with timestamps and metadata.
4. Includes entry titles, photos/attachments indicators, and full context.

Example Output:

📅 On This Day (06-14) - Found 2 entries:

🗓️ 2023 (2 years ago):
   • Morning thoughts (8:30 AM) [Personal] - Reflection on summer goals and upcoming 
     vacation plans. Looking forward to some time off to recharge and spend time with family.
   
🗓️ 2021 (4 years ago):
   • Weekend activities (2:15 PM) [Travel] ⭐ - Great day exploring the local farmers market. 
     Tried some amazing local honey and picked up fresh ingredients for dinner. This entry 
     includes photos. #weekend #local #food

No entries found for June 14th in other years (searched back 5 years).

This provides a powerful way to:

• Reflect on past experiences from the same date.
• Track personal growth across years.
• Rediscover forgotten memories and insights.
• See patterns in your life and thinking.

✍️ Creating Entries

• "Create a journal entry about my day" - Creates an entry with your content.
• "Create a starred entry about my vacation with photos from /path/to/photo.jpg" - Creates entries with attachments and metadata.
• "Add a journal entry with location coordinates for my current trip" - Creates location-aware entries.
• "Add tags #work #meeting to an entry about the team standup" - Creates tagged entries.

📖 Reading & Searching

• "Show me my recent journal entries" - Displays recent entries with dates, tags, and previews.
• "Search my journal for entries about work" - Finds entries containing specific text.
• "What were my journal entries on this day?" - NEW: Shows "On This Day" entries from previous years.
• "Show me entries from June 14th in past years" - NEW: Date-specific historical entries.
• "List my Day One journals with entry counts" - Shows actual journals and statistics.
• "How many entries do I have?" - Gets real entry counts from the database.
• "Find entries from last week" - Search by date ranges.

📚 Documentation

Available MCP Tools

✍️ Write Tools (CLI-based)

1. create_journal_entry - Create entries with rich metadata (attachments, location, tags, etc.).
2. create_entry_with_attachments - Specialized for file attachments (photos, videos, audio, PDFs).
3. create_location_entry - Specialized for location-aware entries with coordinates.

📖 Read Tools (Database-based)

4. read_recent_entries - NEW: Read recent journal entries with full metadata.

   • Parameters: limit (1-50), journal (optional filter).
   • Returns: Formatted entries with dates, tags, previews, starred status.

5. search_entries - NEW: Search entries by text content.

   • Parameters: search_text, limit (1-50), journal (optional filter).
   • Returns: Matching entries with context and metadata.

6. list_journals_from_db - NEW: List actual journals with statistics.

   • Returns: Journal names, entry counts, last entry dates.

7. get_entry_count_from_db - NEW: Get real entry counts.

   • Parameters: journal (optional filter).
   • Returns: Actual entry count from the database.

8. get_entries_by_date - NEW: Get "On This Day" entries from previous years.

   • Parameters: target_date (MM-DD or YYYY-MM-DD), years_back (default 5).
   • Returns: Entries from the same date across multiple years with full content.

📋 Legacy Tools (CLI limitations)

9. list_journals - Provides guidance about CLI limitations.
10. get_entry_count - Explains CLI counting limitations.

🔧 Technical Details

# Install development dependencies
uv sync --dev

# Run the server directly (for testing)
uv run python -m mcp_dayone.server

# Run tests (when implemented)
uv run pytest

Troubleshooting

Day One CLI Not Found

• Verify Day One CLI is installed: dayone2 --version.
• Check that dayone2 is in your PATH.
• Install the Day One app and CLI from: https://dayoneapp.com/guides/tips-and-tutorials/command-line-interface-cli.

Claude Desktop Connection Issues

• Verify the absolute path in claude_desktop_config.json.
• Check Claude Desktop logs for MCP server errors.
• Restart Claude Desktop after configuration changes.

Permission Issues

• Ensure Day One CLI has proper permissions to access your journals.
• Run the Day One app once to initialize if needed.

CLI Limitations

• The Day One CLI only supports creating entries (new command).
• Listing journals and counting entries are not supported by the CLI.
• Use the Day One app interface to view journals and entry counts.
• All entry creation features (attachments, location, etc.) work fully.

📄 License

MIT