LunaTask MCP Server

Instructions

Implementation Reference

• src/lunatask_mcp/tools/people.py:283-357 (handler)

  The handler function that executes the "create_person_timeline_note" tool logic.

  async def create_person_timeline_note_tool(
      self,
      ctx: ServerContext,
      person_id: str,
      content: str,
      date_on: str | None = None,
  ) -> dict[str, Any]:
      """Create a timeline note for a person in LunaTask.
  
      Args:
          ctx: Server context for logging and communication
          person_id: ID of the person to add the timeline note to
          content: Content of the timeline note
          date_on: Optional date in YYYY-MM-DD format to associate with the note
  
      Returns:
          Dictionary with success status, person_timeline_note_id, and message.
      """
  
      await ctx.info("Creating person timeline note")
  
      if not person_id.strip():
          message = "person_id is required to create a timeline note"
          await ctx.error(message)
          logger.warning("Missing person_id for person timeline note creation")
          return {
              "success": False,
              "error": "validation_error",
              "message": message,
          }
  
      if content.strip() == "":
          message = "content cannot be empty when creating a timeline note"
          await ctx.error(message)
          logger.warning("Empty content provided for person timeline note creation")
          return {
              "success": False,
              "error": "validation_error",
              "message": message,
          }
  
      parsed_date: date_class | None = None
      if date_on is not None:
          try:
              parsed_date = date_class.fromisoformat(date_on)
          except ValueError as error:
              message = f"Invalid date_on format. Expected YYYY-MM-DD format: {error!s}"
              await ctx.error(message)
              logger.warning("Invalid date_on provided for person timeline note: %s", date_on)
              return {
                  "success": False,
                  "error": "validation_error",
                  "message": message,
              }
  
      note_payload = PersonTimelineNoteCreate(
          person_id=person_id,
          content=content.strip(),
          date_on=parsed_date,
      )
  
      try:
          async with self.lunatask_client as client:
              note_response = await client.create_person_timeline_note(note_payload)
  
      except Exception as error:
          return await self._handle_lunatask_api_errors(ctx, error, "timeline note creation")
  
      await ctx.info(f"Person timeline note created: {note_response.id}")
      logger.info("Created person timeline note %s", note_response.id)
      return {
          "success": True,
          "person_timeline_note_id": note_response.id,
          "message": "Person timeline note created successfully",
      }

• src/lunatask_mcp/tools/people.py:449-463 (registration)

  Tool registration for "create_person_timeline_note".

  async def _create_person_timeline_note(
      ctx: ServerContext,
      person_id: str,
      content: str,
      date_on: str | None = None,
  ) -> dict[str, Any]:
      return await self.create_person_timeline_note_tool(ctx, person_id, content, date_on)
  
  self.mcp.tool(
      name="create_person_timeline_note",
      description=(
          "Create a timeline note for a person in LunaTask. Requires person_id and content. "
          "Optional date_on (YYYY-MM-DD) to associate the note with a specific day."
      ),
  )(_create_person_timeline_note)