Joplin MCP Server

Instructions

Args:
    note_id: ID of note to delete
    permanent: If True, permanently delete the note

Returns:
    Dictionary containing the operation status

Implementation Reference

• src/mcp/joplin_mcp.py:209-231 (handler)

  MCP tool handler for delete_note: calls JoplinAPI.delete_note and returns success/error response.

  @mcp.tool()
  async def delete_note(note_id: str, permanent: bool = False) -> Dict[str, Any]:
      """Delete a note from Joplin.
      
      Args:
          note_id: ID of note to delete
          permanent: If True, permanently delete the note
      
      Returns:
          Dictionary containing the operation status
      """
      if not api:
          return {"error": "Joplin API client not initialized"}
      
      try:
          api.delete_note(note_id, permanent=permanent)
          return {
              "status": "success",
              "message": f"Note {note_id} {'permanently ' if permanent else ''}deleted"
          }
      except Exception as e:
          logger.error(f"Error deleting note: {e}")
          return {"error": str(e)}

• src/joplin/joplin_api.py:363-373 (helper)

  JoplinAPI helper method that sends DELETE request to Joplin server endpoint for the note.

  def delete_note(self, note_id: str, permanent: bool = False) -> None:
      """Delete a note.
  
      Args:
          note_id: ID of note to delete
          permanent: If True, permanently delete the note
      """
      endpoint = f"notes/{note_id}"
      if permanent:
          endpoint += "?permanent=1"
      self._make_request("DELETE", endpoint)