quevin/mcp-dayone
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
An MCP for Day One Journal users.
개요
A Model Context Protocol (MCP) server for Day One Journal integration with Claude Desktop. 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. - 📝 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 recent journal entries with full metadata - 🔍 : Search entries by text content - 📚 : List actual journals with entry counts and statistics - 📊 : Get real entry counts from database - 🏷️ : View entry tags, dates, and metadata - Proper error handling and validation - Direct SQLite database integration for read operations - Hybrid approach: CLI for writing, database for reading - 🚀 Easy installation...
README
원문 README의 일부입니다. 원문 보기.
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:
- Download and install Day One from the Mac App Store or Day One website
- The Day One CLI is automatically included with the app - no separate installation needed!
- 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": {설치
This server does not publish a one-line install command.
Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →설정
{
"mcpServers": {
"dayone": {
"command": "uv",
"args": [
"--directory",
"/FULL/PATH/TO/mcp-dayone",
"run",
"python",
"-m",
"mcp_dayone.server"
]
}
}
}