How do I install the Joplin Create Note skill?

Run npx skillmds@latest add leixinsun/joplin-create-note in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Joplin Create Note skill do?

Create, update, or delete notes in Joplin It is listed under Coding & Dev Tools on SkillMD.

Is Joplin Create Note safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Joplin Create Note?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Joplin Create Note free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Joplin Create Note?

LeixinSun (@leixinsun) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Joplin Create Note by leixinsun — Agent Skill

Name: Joplin Create Note
Rating: 4.5 (4 reviews)
Author: LeixinSun

File contents

Joplin Create/Edit/Delete Note

This skill creates, updates, and deletes notes in Joplin via the REST API.

Configuration

Base URL: http://localhost:${JOPLIN_PORT:-41184}
Auth Token: $JOPLIN_TOKEN

Create a Note

curl -s -X POST "http://localhost:${JOPLIN_PORT:-41184}/notes?token=$JOPLIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "NOTE_TITLE",
    "body": "MARKDOWN_BODY",
    "parent_id": "NOTEBOOK_ID",
    "is_todo": 0,
    "tags": "tag1,tag2"
  }'

Fields

Field	Required	Description
`title`	Yes	Note title
`body`	No	Note content in Markdown (or HTML if `markup_language=2`)
`parent_id`	No	Notebook ID to place note in. If omitted, goes to default notebook.
`is_todo`	No	`0` = regular note (default), `1` = todo/checkbox item
`todo_due`	No	Due date as Unix timestamp in milliseconds
`todo_completed`	No	Completion timestamp in ms (`0` = not completed)
`tags`	No	Comma-separated tag titles. Tags are created if they don't exist.
`markup_language`	No	`1` = Markdown (default), `2` = HTML
`source_url`	No	Source URL for the note

Finding the notebook ID

If the user specifies a notebook by name, look it up first:

curl -s "http://localhost:${JOPLIN_PORT:-41184}/search?query=NOTEBOOK_NAME&type=folder&token=$JOPLIN_TOKEN&fields=id,title"

Or list all notebooks:

curl -s "http://localhost:${JOPLIN_PORT:-41184}/folders?token=$JOPLIN_TOKEN&fields=id,title,parent_id"

Update a Note

curl -s -X PUT "http://localhost:${JOPLIN_PORT:-41184}/notes/NOTE_ID?token=$JOPLIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Updated Title",
    "body": "Updated markdown content"
  }'

Only include fields you want to change. Omitted fields are not modified.

Finding a note to update

Search by title:

curl -s "http://localhost:${JOPLIN_PORT:-41184}/search?query=title:NOTE_TITLE&token=$JOPLIN_TOKEN&fields=id,title,parent_id,updated_time"

Delete a Note

curl -s -X DELETE "http://localhost:${JOPLIN_PORT:-41184}/notes/NOTE_ID?token=$JOPLIN_TOKEN"

Always confirm with the user before deleting a note.

Create a Note with Resource Links

To reference an existing resource (attachment) in a note:

![image description](:/${resource_id})
[file name](:/${resource_id})

Workflow

If user specifies a notebook name, resolve it to an ID first.
Create/update/delete the note.
Report back the note ID and title on success.
On error, report the error message and suggest fixes.

Error Handling

403: Invalid token — check $JOPLIN_TOKEN
404: Note or notebook not found — verify the ID
Connection refused: Joplin not running or Web Clipper disabled

Tips

When creating long notes, use a heredoc or write the body to a temp file to avoid shell escaping issues:

BODY=$(cat <<'NOTEEOF'
# My Note

This is the **content** with special characters: "quotes", 'apostrophes', and $dollars.
NOTEEOF
)
curl -s -X POST "http://localhost:${JOPLIN_PORT:-41184}/notes?token=$JOPLIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg title "My Note" --arg body "$BODY" '{title: $title, body: $body}')"

Use jq for constructing JSON payloads to handle escaping properly.

---name: joplin-create-notedescription: Create, update, or delete notes in Joplin---# Joplin Create/Edit/Delete NoteThis skill creates, updates, and deletes notes in Joplin via the REST API.## Configuration- **Base URL**: `http://localhost:${JOPLIN_PORT:-41184}`- **Auth Token**: `$JOPLIN_TOKEN`## Create a Note```bashcurl -s -X POST "http://localhost:${JOPLIN_PORT:-41184}/notes?token=$JOPLIN_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "NOTE_TITLE", "body": "MARKDOWN_BODY", "parent_id": "NOTEBOOK_ID", "is_todo": 0, "tags": "tag1,tag2" }'```### Fields| Field | Required | Description ||-------|----------|-------------|| `title` | Yes | Note title || `body` | No | Note content in Markdown (or HTML if `markup_language=2`) || `parent_id` | No | Notebook ID to place note in. If omitted, goes to default notebook. || `is_todo` | No | `0` = regular note (default), `1` = todo/checkbox item || `todo_due` | No | Due date as Unix timestamp in milliseconds || `todo_completed` | No | Completion timestamp in ms (`0` = not completed) || `tags` | No | Comma-separated tag titles. Tags are created if they don't exist. || `markup_language` | No | `1` = Markdown (default), `2` = HTML || `source_url` | No | Source URL for the note |### Finding the notebook IDIf the user specifies a notebook by name, look it up first:```bashcurl -s "http://localhost:${JOPLIN_PORT:-41184}/search?query=NOTEBOOK_NAME&type=folder&token=$JOPLIN_TOKEN&fields=id,title"```Or list all notebooks:```bashcurl -s "http://localhost:${JOPLIN_PORT:-41184}/folders?token=$JOPLIN_TOKEN&fields=id,title,parent_id"```## Update a Note```bashcurl -s -X PUT "http://localhost:${JOPLIN_PORT:-41184}/notes/NOTE_ID?token=$JOPLIN_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "title": "Updated Title", "body": "Updated markdown content" }'```Only include fields you want to change. Omitted fields are not modified.### Finding a note to updateSearch by title:```bashcurl -s "http://localhost:${JOPLIN_PORT:-41184}/search?query=title:NOTE_TITLE&token=$JOPLIN_TOKEN&fields=id,title,parent_id,updated_time"```## Delete a Note```bashcurl -s -X DELETE "http://localhost:${JOPLIN_PORT:-41184}/notes/NOTE_ID?token=$JOPLIN_TOKEN"```**Always confirm with the user before deleting a note.**## Create a Note with Resource LinksTo reference an existing resource (attachment) in a note:```markdown![image description](:/${resource_id})[file name](:/${resource_id})```## Workflow1. If user specifies a notebook name, resolve it to an ID first.2. Create/update/delete the note.3. Report back the note ID and title on success.4. On error, report the error message and suggest fixes.## Error Handling- **403**: Invalid token — check `$JOPLIN_TOKEN`- **404**: Note or notebook not found — verify the ID- **Connection refused**: Joplin not running or Web Clipper disabled## Tips- When creating long notes, use a heredoc or write the body to a temp file to avoid shell escaping issues: ```bash BODY=$(cat <<'NOTEEOF' # My Note This is the **content** with special characters: "quotes", 'apostrophes', and $dollars. NOTEEOF ) curl -s -X POST "http://localhost:${JOPLIN_PORT:-41184}/notes?token=$JOPLIN_TOKEN" \ -H "Content-Type: application/json" \ -d "$(jq -n --arg title "My Note" --arg body "$BODY" '{title: $title, body: $body}')" ```- Use `jq` for constructing JSON payloads to handle escaping properly.

Frequently asked questions

Joplin Create Note