// MCP TOOL REFERENCE

PYPI:JOPLIN TOOLS

32 tools from the Pypi:joplin MCP Server, categorised by risk level.

View the Pypi:joplin policy → Token cost: 4,440 tokens →

// ALL 32 PYPI:JOPLIN TOOLS

READ 18 tools

Read append_to_note Append content to the end of an existing note. Read download_attachment Download a file attachment from Joplin by resource ID. Saves to specified path. Read get_note Get the full content of a specific note by ID. Returns title, body (content), notebook, timestamps, and tags. Read get_note_attachments List all file attachments in a specific note. Optionally sort results. Read get_notebook_by_id Get a specific notebook by ID. Returns notebook title, parent_id, and timestamps. Read get_notebook_notes Get all notes from a specific notebook. Returns note titles, IDs, and metadata. Optionally sort results. Read get_notes_by_tag Get all notes that have a specific tag. Provide either tag_id or tag_name. Optionally sort results. Read get_resource_metadata Get metadata for a specific resource/attachment including size, MIME type, OCR text, and timestamps. Read get_resource_notes Find all notes that reference/use a specific resource/attachment. Essential before deleting a resource. Opt... Read get_revision Get details of a specific revision by ID. Returns the diff showing what changed (title_diff, body_diff, met... Read get_tag_by_id Get a specific tag by ID. Returns tag title and timestamps. Read list_all_notes List all notes across all notebooks. Returns note titles, IDs, content, and metadata. Optionally include de... Read list_all_resources List all file attachments (images, PDFs, etc.) across all notes. Returns metadata including OCR text if ava... Read list_all_revisions List all revisions (version history) across all notes. Returns revision IDs, item_id (note ID), timestamps,... Read list_notebooks List all notebooks (folders) in Joplin. Returns notebook ID, title, parent ID, and timestamps. Optionally s... Read list_tags List all tags in Joplin. Returns tag IDs, names, and timestamps. Optionally sort results. Read prepend_to_note Prepend content to the beginning of an existing note. Read search_notes Search for notes using Joplin's powerful query syntax. Basic syntax: - Single/multiple words: "linux kerne...

WRITE 9 tools

Write add_tags_to_note Add tags to an existing note. Tags will be created if they don't exist. Tags are added to any existing tags... Write create_note Create a new note with title and body content. Can create regular notes or todos with due dates. Optionally... Write create_notebook Create a new notebook in Joplin. Optionally nest it under a parent notebook. Write move_note_to_notebook Move a note to a different notebook. Write rename_tag Rename a tag. All notes with this tag will show the new name. Provide either tag_id or current_name. Write update_note Update an existing note. Can update title, body, notebook, or convert to/from todo. Use add_tags_to_note or... Write update_notebook Update notebook properties (rename or move to different parent). Write update_resource Update a resource/attachment. Can update file content, metadata (title), or both. Write upload_attachment Upload a file attachment (image, PDF, etc.) to Joplin. Returns resource ID that can be referenced in notes.

DESTRUCTIVE 5 tools

Destructive delete_note Delete a note (moves it to the trash). Destructive delete_notebook Delete a notebook. The notebook must be empty. Destructive delete_resource Delete a resource/attachment from Joplin. WARNING: This will break references in notes that use this resour... Destructive delete_tag Delete a tag from Joplin. All notes will no longer have this tag. Destructive remove_tags_from_note Remove specific tags from a note. Silently ignores tags that don't exist or aren't on the note.

// RUNNING THIS SERVER

The managed route: connect Pypi:joplin through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y pypi:joplin-mcp

// FAQ

How many tools does the Pypi:joplin MCP server have? +

The Pypi:joplin MCP server exposes 32 tools across 3 categories: Read, Write, Destructive.

How do I enforce policies on Pypi:joplin tools? +

Route the Pypi:joplin server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Pypi:joplin tools fall into? +

Pypi:joplin tools are categorised as Read (18), Write (9), Destructive (5). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.