Shared lists and events: Justy drafts a list from one sentence; guests claim items from a link.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add items to an existing list the user is on (their own or one shared with them). Use list_my_lists first to find the list id, e.g. for "add milk and eggs to my weekly list". People sharing the list see the items appear.
Items to add
The list's id (listId from list_my_lists, create_list or write_list_with_justy)
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http just-list https://justlistapp.com/mcp
Add items to an existing list the user is on (their own or one shared with them). Use list_my_lists first to find the list id, e.g. for "add milk and eggs to my weekly list". People sharing the list see the items appear.
| Argument | Type | Description |
|---|---|---|
| items* | array | Items to add |
| listId* | string | The list's id (listId from list_my_lists, create_list or write_list_with_justy) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listId",
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"maxItems": 50,
"minItems": 1,
"description": "Items to add"
},
"listId": {
"type": "string",
"maxLength": 64,
"minLength": 8,
"description": "The list's id (listId from list_my_lists, create_list or write_list_with_justy)"
}
}
}For a guest: claim something to bring on a Just List Event, using the guest link the host sent and the guest's first name — exactly what the guest page allows. Pass the item's text as shown on the Event. If the item is not found, the reply lists what is still open.
| Argument | Type | Description |
|---|---|---|
| item* | string | The item to claim, as written on the Event |
| quantity | integer | How many of it the guest brings (default 1) |
| firstName* | string | The guest's first name, shown to the host and other guests |
| guestLink* | string | The Event guest link (…/p/<code>) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"guestLink",
"item",
"firstName"
],
"properties": {
"item": {
"type": "string",
"maxLength": 300,
"minLength": 1,
"description": "The item to claim, as written on the Event"
},
"quantity": {
"type": "integer",
"maximum": 99,
"minimum": 1,
"description": "How many of it the guest brings (default 1)"
},
"firstName": {
"type": "string",
"maxLength": 50,
"minLength": 1,
"description": "The guest's first name, shown to the host and other guests"
},
"guestLink": {
"type": "string",
"maxLength": 300,
"minLength": 4,
"description": "The Event guest link (…/p/<code>)"
}
}
}Create an Event (a dinner, a party, a class trip…) with the things people should bring, each with a quantity. Returns a guest link: guests open it in any browser, no app or account, and claim items with their first name. For "a birthday lunch with 12 guests", suggest items sized for 12.
| Argument | Type | Description |
|---|---|---|
| date | string | Local date (YYYY-MM-DD) or local date and time (YYYY-MM-DDTHH:mm), as the host means it — no time zone |
| items* | array | What guests can bring, with how many are needed |
| title* | string | Event name |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"title",
"items"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2})?$",
"description": "Local date (YYYY-MM-DD) or local date and time (YYYY-MM-DDTHH:mm), as the host means it — no time zone"
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"quantity": {
"type": "integer",
"maximum": 99,
"minimum": 1
}
}
},
"maxItems": 50,
"minItems": 1,
"description": "What guests can bring, with how many are needed"
},
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Event name"
}
}
}Create a new list in the user's Just List account with a title and, optionally, items exactly as given (no Justy). Returns the list's id and link.
| Argument | Type | Description |
|---|---|---|
| kind | string | shopping, todo or general (default general) |
| items | array | Items to add, in order |
| title* | string | List title |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"title"
],
"properties": {
"kind": {
"enum": [
"shopping",
"todo",
"general"
],
"type": "string",
"description": "shopping, todo or general (default general)"
},
"items": {
"type": "array",
"items": {
"type": "string",
"maxLength": 1000,
"minLength": 1
},
"maxItems": 50,
"description": "Items to add, in order"
},
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "List title"
}
}
}Turn one sentence about a plan or errand (for example "Friday dinner for 8", "packing for a weekend with kids", "ערב שישי ל-8") into a ready-to-use list written by Justy. No account needed. Returns the items (grouped by aisle for shopping lists) and a justlistapp.com link where the user can keep the list, share it, or open it in the app. Use this when the user wants a list drafted and has not connected a Just List account; with a connected account prefer write_list_with_justy, which saves it.
| Argument | Type | Description |
|---|---|---|
| lang | string | Language for the list when the sentence alone is ambiguous: he (Hebrew) or en (English). Defaults to the sentence's language. |
| sentence* | string | The user's request in one sentence, in their own words and language |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sentence"
],
"properties": {
"lang": {
"enum": [
"he",
"en"
],
"type": "string",
"description": "Language for the list when the sentence alone is ambiguous: he (Hebrew) or en (English). Defaults to the sentence's language."
},
"sentence": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "The user's request in one sentence, in their own words and language"
}
}
}For one of the user's Events: who claimed what and what is still unclaimed. Pass the guest link, or nothing for the most recent Event. Answers "what's still unclaimed on my event?".
| Argument | Type | Description |
|---|---|---|
| event | string | The Event's guest link (…/p/<code>); omit for the most recent Event |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"event": {
"type": "string",
"maxLength": 300,
"description": "The Event's guest link (…/p/<code>); omit for the most recent Event"
}
}
}Read one of the user's lists: its items with checked/unchecked state and the first names of the people it is shared with.
| Argument | Type | Description |
|---|---|---|
| listId* | string | The list's id (listId from list_my_lists, create_list or write_list_with_justy) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listId"
],
"properties": {
"listId": {
"type": "string",
"maxLength": 64,
"minLength": 8,
"description": "The list's id (listId from list_my_lists, create_list or write_list_with_justy)"
}
}
}The user's recent lists (most recently changed first, archived ones left out) with their ids, plus their recent Events. Use it to find the list id for add_items, get_list or share_link.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many lists (default 20) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "How many lists (default 20)"
}
}
}Make an invite link for one of the user's own lists. Anyone who opens it can join the list and edit it with them. Only for lists the user created.
| Argument | Type | Description |
|---|---|---|
| listId* | string | The list's id (listId from list_my_lists, create_list or write_list_with_justy) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listId"
],
"properties": {
"listId": {
"type": "string",
"maxLength": 64,
"minLength": 8,
"description": "The list's id (listId from list_my_lists, create_list or write_list_with_justy)"
}
}
}Read-only. Open a Just List Event guest link (…/p/<code>) and see what the host asked people to bring and what is still unclaimed, exactly as the guest page shows it. No account needed. Use it before claim_item, or when a user pastes a guest link and asks "what is still needed?".
| Argument | Type | Description |
|---|---|---|
| guestLink* | string | The Event guest link (…/p/<code>) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"guestLink"
],
"properties": {
"guestLink": {
"type": "string",
"maxLength": 300,
"minLength": 4,
"description": "The Event guest link (…/p/<code>)"
}
}
}Justy writes a list from one sentence (for example "shopping for Friday dinner for 8") and saves it to the user's Just List account. Shopping lists come sorted by aisle. Returns the saved list's id and link. Counts toward the account's daily Justy lists; when those are used up it says so, and create_list still works.
| Argument | Type | Description |
|---|---|---|
| lang | string | he or en when the sentence alone is ambiguous |
| sentence* | string | The user's request in one sentence, in their own words and language |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sentence"
],
"properties": {
"lang": {
"enum": [
"he",
"en"
],
"type": "string",
"description": "he or en when the sentence alone is ambiguous"
},
"sentence": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "The user's request in one sentence, in their own words and language"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.