Obsidian MCP Server

Instructions

Implementation Reference

• src/obsidian_mcp/server.py:758-802 (handler)

  MCP tool handler function that exposes get_daily_note tool, parses args, calls vault method, and formats response.

  @mcp.tool(name="get_daily_note", description="Get or create a daily note for a specific date")
  async def get_daily_note(
      date_str: str = "", folder: str = "Daily Notes", create: bool = True
  ) -> str:
      """
      Get or create a daily note.
  
      Args:
          date_str: Date in YYYY-MM-DD format (empty for today)
          folder: Folder where daily notes are stored
          create: If true, create the note if it doesn't exist
  
      Returns:
          Daily note content
      """
      context = _get_context()
  
      try:
          # Parse date
          if date_str:
              target_date = datetime.strptime(date_str, "%Y-%m-%d").date()
          else:
              target_date = None
  
          note = await context.vault.get_daily_note(target_date, folder, create)
  
          result = f"# Daily Note: {note.path}\n\n"
          if note.frontmatter:
              result += "## Frontmatter\n```yaml\n"
              result += yaml.dump(note.frontmatter, default_flow_style=False)
              result += "```\n\n"
  
          result += "## Content\n"
          result += note.body
  
          return result
  
      except ValueError as e:
          return f"Error: Invalid date format (use YYYY-MM-DD): {e}"
      except FileNotFoundError:
          return f"Error: Daily note not found for {date_str}"
      except Exception as e:
          logger.exception("Error getting daily note")
          return f"Error getting daily note: {e}"

• src/obsidian_mcp/vault.py:665-703 (handler)

  Core implementation in ObsidianVault class: computes path, reads existing or creates new daily note with default content/frontmatter.

  async def get_daily_note(
      self,
      target_date: date | None = None,
      folder: str = "Daily Notes",
      create_if_missing: bool = True,
  ) -> Note:
      """
      Get or create a daily note.
  
      Args:
          target_date: Date for the daily note (defaults to today)
          folder: Folder where daily notes are stored
          create_if_missing: If True, create the note if it doesn't exist
  
      Returns:
          Daily note
      """
      if target_date is None:
          target_date = date.today()
  
      note_path = self.get_daily_note_path(target_date, folder)
  
      # Try to read existing note
      try:
          return await self.read_note(note_path)
      except FileNotFoundError:
          if not create_if_missing:
              raise
  
          # Create new daily note
          frontmatter = {
              "date": target_date.strftime("%Y-%m-%d"),
              "tags": ["daily-note"],
          }
  
          content = f"# {target_date.strftime('%A, %B %d, %Y')}\n\n"
  
          self.create_note(note_path, content, frontmatter)
          return await self.read_note(note_path)

• src/obsidian_mcp/vault.py:642-664 (helper)

  Helper method to generate the filename and path for a daily note based on date and folder.

  def get_daily_note_path(
      self, target_date: date | None = None, folder: str = "Daily Notes"
  ) -> str:
      """
      Get the path for a daily note.
  
      Args:
          target_date: Date for the daily note (defaults to today)
          folder: Folder where daily notes are stored
  
      Returns:
          Relative path to the daily note
      """
      if target_date is None:
          target_date = date.today()
  
      # Format: YYYY-MM-DD.md
      filename = f"{target_date.strftime('%Y-%m-%d')}.md"
  
      if folder:
          return f"{folder}/{filename}"
      return filename