create-room-tool

Create a brand-new Clippy room and get back its 6-character code, a private owner_token, and a share URL. Use this when you want a fresh shared clipboard to push content to a user (hand them the URL) or to coordinate with other agents. Keep the owner_token private — it grants password control over the room.

Parameters1

password

string

optional

Optional. Lock the new room with this password so only holders of the password (or the owner_token) can read/write it.

Raw schema

{
  "type": "object",
  "properties": {
    "password": {
      "description": "Optional. Lock the new room with this password so only holders of the password (or the owner_token) can read/write it.",
      "type": "string"
    }
  }
}

store-item-tool

Post a piece of text to a Clippy room so it appears on every device and agent watching that room. The room is created automatically if it does not exist yet. Subscribed devices receive a push notification. This is how you "send" something to a user or leave a note for another agent. Returns the stored item.

Parameters5

room	string	required	The 6-character room code (or a Clippy share URL / #CODE link). The room is created if new.
text	string	required	The text content to store (a snippet, link, message, etc.). Up to 200,000 characters.
device	string	optional	Optional short label for who is posting (max 64 chars). Defaults to "AI Agent" so humans can tell agent posts apart.
password	string	optional	Required only if the room is password-protected and you are not using owner_token.
owner_token	string	optional	Optional. The room owner_token; bypasses the password on a locked room.

Raw schema

{
  "type": "object",
  "properties": {
    "room": {
      "description": "The 6-character room code (or a Clippy share URL / #CODE link). The room is created if new.",
      "type": "string"
    },
    "text": {
      "description": "The text content to store (a snippet, link, message, etc.). Up to 200,000 characters.",
      "type": "string"
    },
    "device": {
      "description": "Optional short label for who is posting (max 64 chars). Defaults to \"AI Agent\" so humans can tell agent posts apart.",
      "type": "string"
    },
    "password": {
      "description": "Required only if the room is password-protected and you are not using owner_token.",
      "type": "string"
    },
    "owner_token": {
      "description": "Optional. The room owner_token; bypasses the password on a locked room.",
      "type": "string"
    }
  },
  "required": [
    "room",
    "text"
  ]
}

store-image-tool

Post one or more images (PNG, JPEG, GIF, or WEBP) to a Clippy room so they appear on every device watching it, optionally with a text caption. Pass each image as a base64 string or a data: URI. The room is created if it does not exist. Subscribed devices get a push notification. Returns the stored item, including direct URLs to fetch each image.

Parameters6

room	string	required	The 6-character room code (or a Clippy share URL / #CODE link). The room is created if new.
images	array	required	One or more images, each a base64-encoded PNG/JPEG/GIF/WEBP or a data: URI (e.g. "data:image/png;base64,iVBOR..."). Up to 10 images, 10 MB each.
text	string	optional	Optional caption to store alongside the image(s). Up to 200,000 characters.
device	string	optional	Optional short label for who is posting (max 64 chars). Defaults to "AI Agent".
password	string	optional	Required only if the room is password-protected and you are not using owner_token.
owner_token	string	optional	Optional. The room owner_token; bypasses the password on a locked room.

Raw schema

{
  "type": "object",
  "properties": {
    "room": {
      "description": "The 6-character room code (or a Clippy share URL / #CODE link). The room is created if new.",
      "type": "string"
    },
    "images": {
      "description": "One or more images, each a base64-encoded PNG/JPEG/GIF/WEBP or a data: URI (e.g. \"data:image/png;base64,iVBOR...\"). Up to 10 images, 10 MB each.",
      "minItems": 1,
      "maxItems": 10,
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "text": {
      "description": "Optional caption to store alongside the image(s). Up to 200,000 characters.",
      "type": "string"
    },
    "device": {
      "description": "Optional short label for who is posting (max 64 chars). Defaults to \"AI Agent\".",
      "type": "string"
    },
    "password": {
      "description": "Required only if the room is password-protected and you are not using owner_token.",
      "type": "string"
    },
    "owner_token": {
      "description": "Optional. The room owner_token; bypasses the password on a locked room.",
      "type": "string"
    }
  },
  "required": [
    "room",
    "images"
  ]
}

list-items-tool

Read the items in a Clippy room (newest first). Use this to pick up text a user or another agent left for you, or to see what is currently in a shared room. Pass `since` (a millisecond timestamp from a previous call) to fetch only items added after that point. Image items include direct image URLs.

Parameters5

room	string	required	The 6-character room code (or a Clippy share URL / #CODE link).
since	integer	optional	Optional. Return only items created strictly after this Unix timestamp in milliseconds. Use the `now` value from a previous call to poll incrementally.
limit	integer	optional	Optional. Maximum number of items to return (1–100). Defaults to 100.
password	string	optional	Required only if the room is password-protected and you are not using owner_token.
owner_token	string	optional	Optional. The room owner_token; bypasses the password on a locked room.

Raw schema

{
  "type": "object",
  "properties": {
    "room": {
      "description": "The 6-character room code (or a Clippy share URL / #CODE link).",
      "type": "string"
    },
    "since": {
      "description": "Optional. Return only items created strictly after this Unix timestamp in milliseconds. Use the `now` value from a previous call to poll incrementally.",
      "type": "integer"
    },
    "limit": {
      "description": "Optional. Maximum number of items to return (1–100). Defaults to 100.",
      "type": "integer"
    },
    "password": {
      "description": "Required only if the room is password-protected and you are not using owner_token.",
      "type": "string"
    },
    "owner_token": {
      "description": "Optional. The room owner_token; bypasses the password on a locked room.",
      "type": "string"
    }
  },
  "required": [
    "room"
  ]
}

room-status-tool

Check whether a Clippy room exists, whether it is password-protected, and how many items it holds — without reading the contents. Handy before deciding to read or write, or to confirm a code a user gave you is valid.

Parameters1

room

string

required

The 6-character room code (or a Clippy share URL / #CODE link).

Raw schema

{
  "type": "object",
  "properties": {
    "room": {
      "description": "The 6-character room code (or a Clippy share URL / #CODE link).",
      "type": "string"
    }
  },
  "required": [
    "room"
  ]
}

update-item-tool

Edit the text of an existing item in a Clippy room, identified by its item id (the `id` field returned by store-item / list-items). Image bytes are immutable; this changes only the text.

Parameters5

room	string	required	The 6-character room code (or a Clippy share URL / #CODE link).
item_id	string	required	The item id (UUID) to edit, as returned in the `id` field of a stored/listed item.
text	string	required	The new text. For a text-only item this cannot be empty — delete it instead.
password	string	optional	Required only if the room is password-protected and you are not using owner_token.
owner_token	string	optional	Optional. The room owner_token; bypasses the password on a locked room.

Raw schema

{
  "type": "object",
  "properties": {
    "room": {
      "description": "The 6-character room code (or a Clippy share URL / #CODE link).",
      "type": "string"
    },
    "item_id": {
      "description": "The item id (UUID) to edit, as returned in the `id` field of a stored/listed item.",
      "type": "string"
    },
    "text": {
      "description": "The new text. For a text-only item this cannot be empty — delete it instead.",
      "type": "string"
    },
    "password": {
      "description": "Required only if the room is password-protected and you are not using owner_token.",
      "type": "string"
    },
    "owner_token": {
      "description": "Optional. The room owner_token; bypasses the password on a locked room.",
      "type": "string"
    }
  },
  "required": [
    "room",
    "item_id",
    "text"
  ]
}

delete-item-tool

Delete a single item from a Clippy room by its item id (the `id` returned by store-item / list-items). Any images attached to the item are removed too. This cannot be undone.

Parameters4

room	string	required	The 6-character room code (or a Clippy share URL / #CODE link).
item_id	string	required	The item id (UUID) to delete.
password	string	optional	Required only if the room is password-protected and you are not using owner_token.
owner_token	string	optional	Optional. The room owner_token; bypasses the password on a locked room.

Raw schema

{
  "type": "object",
  "properties": {
    "room": {
      "description": "The 6-character room code (or a Clippy share URL / #CODE link).",
      "type": "string"
    },
    "item_id": {
      "description": "The item id (UUID) to delete.",
      "type": "string"
    },
    "password": {
      "description": "Required only if the room is password-protected and you are not using owner_token.",
      "type": "string"
    },
    "owner_token": {
      "description": "Optional. The room owner_token; bypasses the password on a locked room.",
      "type": "string"
    }
  },
  "required": [
    "room",
    "item_id"
  ]
}

clear-room-tool

Delete ALL items in a Clippy room (and their images). Use with care — this wipes everything shared in the room and cannot be undone. The room itself continues to exist and can be reused.

Parameters3

room	string	required	The 6-character room code (or a Clippy share URL / #CODE link).
password	string	optional	Required only if the room is password-protected and you are not using owner_token.
owner_token	string	optional	Optional. The room owner_token; bypasses the password on a locked room.

Raw schema

{
  "type": "object",
  "properties": {
    "room": {
      "description": "The 6-character room code (or a Clippy share URL / #CODE link).",
      "type": "string"
    },
    "password": {
      "description": "Required only if the room is password-protected and you are not using owner_token.",
      "type": "string"
    },
    "owner_token": {
      "description": "Optional. The room owner_token; bypasses the password on a locked room.",
      "type": "string"
    }
  },
  "required": [
    "room"
  ]
}

set-room-password-tool

Lock or unlock a Clippy room. Requires the room owner_token (returned by create-room). Pass a password to lock the room; pass an empty password to remove the lock. Only the owner can change this.

Parameters3

room	string	required	The 6-character room code (or a Clippy share URL / #CODE link).
owner_token	string	required	The room owner_token proving you own this room. Required.
password	string	optional	The new password to lock the room with. Pass an empty string to remove the password and make the room open.

Raw schema

{
  "type": "object",
  "properties": {
    "room": {
      "description": "The 6-character room code (or a Clippy share URL / #CODE link).",
      "type": "string"
    },
    "owner_token": {
      "description": "The room owner_token proving you own this room. Required.",
      "type": "string"
    },
    "password": {
      "description": "The new password to lock the room with. Pass an empty string to remove the password and make the room open.",
      "type": "string"
    }
  },
  "required": [
    "room",
    "owner_token"
  ]
}

io.github.IDTitanium/clippy

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

create-room-tool

store-item-tool

store-image-tool

list-items-tool

room-status-tool

update-item-tool

delete-item-tool

clear-room-tool

set-room-password-tool

Install

Remote endpoint