Add or remove tags
Add tags to an article by name, or remove them by ID.
MCP tool instapaper_write → tag_bookmark
write
Adds the tag names you pass, creating any that do not exist, and removes the tag IDs you pass. Removals run before additions. Returns the full tag list of the article afterwards and the tags this call created. Reaches no one and is undone with another call, so it runs without asking.
Parameters
| Name | Type | Description |
|---|---|---|
| bookmark_id integer required | integer | Bookmark ID from list_bookmarks. |
| add_tags string[] | string[] | Tag names to add. |
| remove_tag_ids integer[] | integer[] | Tag IDs to remove, from list_tags. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "instapaper_write",
"arguments": {
"operation": "tag_bookmark",
"arguments": {
"bookmark_id": 1893240551,
"add_tags": [
"Cooking",
"Weeknight"
]
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"bookmark_id": 1893240551,
"created_tags": [
{
"tag_id": 31,
"name": "Weeknight"
}
],
"tags": [
{
"tag_id": 7,
"name": "Cooking"
},
{
"tag_id": 31,
"name": "Weeknight"
}
]
},
"isError": false
}