Obsidian Diary MCP Server

Instructions

Implementation Reference

• src/obsidian_diary_mcp/server.py:22-42 (handler)

  Handler function for 'create_diary_template' tool. Registered via @mcp.tool() decorator. Validates input, checks for existing entry, generates template via template_generator.
  @mcp.tool( annotations={ "title": "Preview Memory Log Template", "readOnlyHint": True, "openWorldHint": False } ) async def create_diary_template( date: Annotated[str, "REQUIRED: Current date in YYYY-MM-DD format. For 'today', pass the current system date like '2025-10-07'"], focus: Annotated[str | None, "Optional focus area (e.g., 'current struggles', 'cognitive patterns')"] = None ) -> str: """Create a sophisticated diary template with intellectually rigorous prompts for deep cognitive exploration.""" try: entry_date = datetime.strptime(date, "%Y-%m-%d") except ValueError: return "Error: Date must be in YYYY-MM-DD format" if entry_manager.entry_exists(entry_date): return f"Memory log for {date} already exists. Use read_diary_entry to view it." return await template_generator.generate_template_content(entry_date, date, focus)
• src/obsidian_diary_mcp/template_generator.py:14-58 (helper)

  Core logic for generating diary template content. Analyzes recent entries, generates AI reflection prompts via analysis_engine, builds template structure. Called by the tool handler.
  async def generate_template_content( self, entry_date: datetime, filename: str, focus: Optional[str] = None ) -> str: """Generate template content for a diary entry.""" from datetime import timedelta log_section(logger, f"Template Generation: {filename}") logger.info(f"Entry date: {entry_date.strftime('%A, %B %d, %Y')}") is_sunday = entry_date.weekday() == 6 if is_sunday: week_start = entry_date - timedelta(days=7) all_entries = entry_manager.get_all_entries() recent_entries = [(date, path) for date, path in all_entries if week_start <= date < entry_date] logger.info(f"Sunday reflection: Analyzing {len(recent_entries)} entries from {week_start.strftime('%Y-%m-%d')} to {(entry_date - timedelta(days=1)).strftime('%Y-%m-%d')}") else: three_days_ago = entry_date - timedelta(days=3) all_entries = entry_manager.get_all_entries() recent_entries = [(date, path) for date, path in all_entries if three_days_ago <= date < entry_date] logger.info(f"Regular day: Analyzing {len(recent_entries)} entries from past 3 calendar days ({three_days_ago.strftime('%Y-%m-%d')} to {(entry_date - timedelta(days=1)).strftime('%Y-%m-%d')})") recent_text = "\n\n".join( f"## {'MOST RECENT ENTRY' if i == 0 else 'Earlier entry'} ({date.strftime('%Y-%m-%d')}):\n{entry_manager.read_entry(path)}" for i, (date, path) in enumerate(recent_entries) ) logger.info(f"Context: {len(recent_text):,} chars from {len(recent_entries)} entries (weighted by recency)") prompt_count = 5 if is_sunday else 3 logger.info(f"Requesting {prompt_count} AI-generated prompts{' with focus: ' + focus if focus else ''}") prompts = await analysis_engine.generate_reflection_prompts( recent_text, focus, prompt_count, is_sunday ) if not prompts: logger.warning("No AI prompts generated, using fallback prompts") prompts = self._get_fallback_prompts(is_sunday) else: logger.info(f"✓ Generated {len(prompts)} AI prompts successfully") return self._build_template(prompts, is_sunday)
• src/obsidian_diary_mcp/server.py:22-28 (registration)

  @mcp.tool() decorator registers the create_diary_template function as an MCP tool with metadata annotations.
  @mcp.tool( annotations={ "title": "Preview Memory Log Template", "readOnlyHint": True, "openWorldHint": False } )
• src/obsidian_diary_mcp/server.py:29-32 (schema)

  Function signature with Annotated types defining input schema and descriptions for the tool.
  async def create_diary_template( date: Annotated[str, "REQUIRED: Current date in YYYY-MM-DD format. For 'today', pass the current system date like '2025-10-07'"], focus: Annotated[str | None, "Optional focus area (e.g., 'current struggles', 'cognitive patterns')"] = None ) -> str: