delete_note
Remove a note from Joplin by specifying its ID, with an option to delete permanently or send to trash.
Instructions
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 statusInput Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note_id | Yes | ||
| permanent | No |
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)