Day One Journal 与 Claude Desktop 集成的模型背景协议(MCP)服务器.

□ 概览

这个 MCP 服务器允许 Claude Desktop 通过模式背景协议与您的 Day One 日记交互 。 克洛德可以创建日记条目,列出可用的日记,并通过自然对话直接获得条目数.

□ 特性

• ** 写操作(第一天CLI)**

• 创建内容和元数据丰富的日记条目
• 在条目中添加附件(相片、视频、音频、PDF)
• 将条目标为明星/重要
• 在条目中添加位置坐标
• 利用时区支持加强日期/时间处理

读取操作(直接数据库访问)

• 📖,NEW: 读取带有完整元数据的最新日记条目
• 🔍,NEW: 按文本内容搜索条目
• 📚,NEW: 列出列有条目数和统计数据的实际日记
• 📊,NEW: 从数据库获取真实的条目数
• 🏷️,NEW: 查看条目标签、日期和元数据

技术*

• 正确处理和验证错误
• 对读操作的直接SQLite数据库集成
• 混合方法:用于写作的CLI,用于读取的数据库
• [[T0] 易于安装

MCP-DayOne

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

Overview

This MCP server enables Claude Desktop to interact with your Day One journal through the Model Context Protocol. Claude can create journal entries, list available journals, and get entry counts directly through natural conversation.

Features

✍️ Write Operations (Day One CLI)

• 📝 Create journal entries with rich content and metadata
• 📎 Add attachments (photos, videos, audio, PDFs) to entries
• ⭐ Mark entries as starred/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 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

Prerequisites

• Day One CLI (dayone2) - Install from Day One website
• Python 3.11+
• uv - Install from astral.sh

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 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 
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": {