Print address labels from a list or a spreadsheet without opening Word.
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.
Use this when the user wants to check or clean a mailing list or contact list before printing labels ("turn my contact list into mailing labels", "address labels from excel spreadsheet", "clean up my address list"): reads an uploaded CSV/XLSX file or a typed list, shows which columns were used for name, street, city, state and ZIP, formats each address the USPS way, and reports missing streets, cities, states, ZIP codes, unknown state codes and duplicates, with a cleaned CSV download. Does not verify that an address exists, does not look up ZIP+4, and does not print the labels (use generate_label_sheet).
Optional uploaded mailing list: a CSV, TSV or Excel .xlsx file with one row per label, e.g. contacts.csv or Christmas list.xlsx. Name, address, city, state and ZIP columns are detected from the headings (Google Contacts, Outlook, Etsy and Shopify exports work).
What the labels are for: address (mailing labels, default), return_address, shipping, name_badge, place_card, file_folder or general text. Sets the default sheet and text style.
Order of the labels: none (list order, default), zip, name or last_name.
Excel sheet name to read, e.g. Guests. Default: the first sheet with data.
The typed or pasted list, one item per label. Either address objects, e.g. [{"name":"Jane Smith","address1":"123 Main St","address2":"Apt 4B","city":"Springfield","state":"IL","zip":"62704"}], or plain text labels with lines separated by \n, e.g. ["Jane Smith\n123 Main St\nSpringfield, IL 62704"]. For name badges use {"name":"Ana Lopez","title":"Engineer","company":"Acme"}.
Optional column mapping when the headings are unusual: heading text or column letter per field, e.g. {"name":"Guest","address1":"Mailing Street","zip":"F"}.
USPS style: all capitals without periods or commas (e.g. SPRINGFIELD IL 62704). Default false.
Whether the file's first row is column headings. Default: detected (headings like Name, Address, ZIP or a first row without numbers).
Also print USA on US addresses that have a country. Default false (non-US countries always print).
Print identical labels only once. Default false (duplicates are counted and reported).
Use this when the user wants to check or clean a mailing list or contact list before printing labels ("turn my contact list into mailing labels", "address labels from excel spreadsheet", "clean up my address list"): reads an uploaded CSV/XLSX file or a typed list, shows which columns were used for name, street, city, state and ZIP, formats each address the USPS way, and reports missing streets, cities, states, ZIP codes, unknown state codes and duplicates, with a cleaned CSV download. Does not verify that an address exists, does not look up ZIP+4, and does not print the labels (use generate_label_sheet).
| Argument | Type | Description |
|---|---|---|
| file | object | Optional uploaded mailing list: a CSV, TSV or Excel .xlsx file with one row per label, e.g. contacts.csv or Christmas list.xlsx. Name, address, city, state and ZIP columns are detected from the headings (Google Contacts, Outlook, Etsy and Shopify exports work). |
| kind | string | What the labels are for: address (mailing labels, default), return_address, shipping, name_badge, place_card, file_folder or general text. Sets the default sheet and text style. |
| sort | string | Order of the labels: none (list order, default), zip, name or last_name. |
| sheet | string | Excel sheet name to read, e.g. Guests. Default: the first sheet with data. |
| labels | array | The typed or pasted list, one item per label. Either address objects, e.g. [{"name":"Jane Smith","address1":"123 Main St","address2":"Apt 4B","city":"Springfield","state":"IL","zip":"62704"}], or plain text labels with lines separated by \n, e.g. ["Jane Smith\n123 Main St\nSpringfield, IL 62704"]. For name badges use {"name":"Ana Lopez","title":"Engineer","company":"Acme"}. |
| columns | object | Optional column mapping when the headings are unusual: heading text or column letter per field, e.g. {"name":"Guest","address1":"Mailing Street","zip":"F"}. |
| uppercase | boolean | USPS style: all capitals without periods or commas (e.g. SPRINGFIELD IL 62704). Default false. |
| has_header | boolean | Whether the file's first row is column headings. Default: detected (headings like Name, Address, ZIP or a first row without numbers). |
| include_country | boolean | Also print USA on US addresses that have a country. Default false (non-US countries always print). |
| remove_duplicates | boolean | Print identical labels only once. Default false (duplicates are counted and reported). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"file_name": {
"type": "string",
"description": "Original file name if known, e.g. statement.pdf."
},
"mime_type": {
"type": "string",
"description": "Media type if known, e.g. application/pdf."
},
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
}
},
"description": "Optional uploaded mailing list: a CSV, TSV or Excel .xlsx file with one row per label, e.g. contacts.csv or Christmas list.xlsx. Name, address, city, state and ZIP columns are detected from the headings (Google Contacts, Outlook, Etsy and Shopify exports work)."
},
"kind": {
"enum": [
"address",
"return_address",
"shipping",
"name_badge",
"place_card",
"file_folder",
"general"
],
"type": "string",
"maxLength": 40,
"description": "What the labels are for: address (mailing labels, default), return_address, shipping, name_badge, place_card, file_folder or general text. Sets the default sheet and text style."
},
"sort": {
"enum": [
"none",
"zip",
"name",
"last_name"
],
"type": "string",
"maxLength": 40,
"description": "Order of the labels: none (list order, default), zip, name or last_name."
},
"sheet": {
"type": "string",
"maxLength": 60,
"description": "Excel sheet name to read, e.g. Guests. Default: the first sheet with data."
},
"labels": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 600
},
{
"type": "object",
"properties": {
"zip": {
"type": "string",
"maxLength": 20,
"description": "ZIP code, e.g. 62704 or 62704-1234."
},
"city": {
"type": "string",
"maxLength": 100,
"description": "City, e.g. Springfield."
},
"name": {
"type": "string",
"maxLength": 200,
"description": "Recipient or person name, e.g. Jane Smith or The Garcia Family."
},
"state": {
"type": "string",
"maxLength": 60,
"description": "State, e.g. IL or Illinois (converted to the USPS two-letter code)."
},
"table": {
"type": "string",
"maxLength": 60,
"description": "Table number or name for place cards, e.g. 4."
},
"title": {
"type": "string",
"maxLength": 200,
"description": "Job title or second line for badges, e.g. Product Manager."
},
"company": {
"type": "string",
"maxLength": 200,
"description": "Company or organization line, e.g. Acme Corp."
},
"country": {
"type": "string",
"maxLength": 60,
"description": "Country for international mail, e.g. Canada. Leave empty for US addresses."
},
"address1": {
"type": "string",
"maxLength": 200,
"description": "Street address, e.g. 123 Main St. A whole one-line address like \"123 Main St, Springfield, IL 62704\" is split automatically."
},
"address2": {
"type": "string",
"maxLength": 200,
"description": "Apartment, suite or unit, e.g. Apt 4B."
}
}
}
]
},
"maxItems": 10000,
"description": "The typed or pasted list, one item per label. Either address objects, e.g. [{\"name\":\"Jane Smith\",\"address1\":\"123 Main St\",\"address2\":\"Apt 4B\",\"city\":\"Springfield\",\"state\":\"IL\",\"zip\":\"62704\"}], or plain text labels with lines separated by \\n, e.g. [\"Jane Smith\\n123 Main St\\nSpringfield, IL 62704\"]. For name badges use {\"name\":\"Ana Lopez\",\"title\":\"Engineer\",\"company\":\"Acme\"}."
},
"columns": {
"type": "object",
"properties": {
"zip": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for zip, e.g. \"Postal Code\" or \"F\"."
},
"city": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for city, e.g. \"city\"."
},
"name": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for name, e.g. \"Full Name\" or \"A\"."
},
"state": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for state, e.g. \"state\"."
},
"table": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for table, e.g. \"table\"."
},
"title": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for title, e.g. \"title\"."
},
"company": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for company, e.g. \"company\"."
},
"country": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for country, e.g. \"country\"."
},
"address1": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for address1, e.g. \"address1\"."
},
"address2": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for address2, e.g. \"address2\"."
},
"last_name": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for last_name, e.g. \"last name\"."
},
"first_name": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for first_name, e.g. \"first name\"."
}
},
"description": "Optional column mapping when the headings are unusual: heading text or column letter per field, e.g. {\"name\":\"Guest\",\"address1\":\"Mailing Street\",\"zip\":\"F\"}."
},
"uppercase": {
"type": "boolean",
"description": "USPS style: all capitals without periods or commas (e.g. SPRINGFIELD IL 62704). Default false."
},
"has_header": {
"type": "boolean",
"description": "Whether the file's first row is column headings. Default: detected (headings like Name, Address, ZIP or a first row without numbers)."
},
"include_country": {
"type": "boolean",
"description": "Also print USA on US addresses that have a country. Default false (non-US countries always print)."
},
"remove_duplicates": {
"type": "boolean",
"description": "Print identical labels only once. Default false (duplicates are counted and reported)."
}
}
}Use this when the user asks which label sheet to use or what the measurements of a sheet are ("avery 5160 size", "avery 5160 label size", "30 labels per sheet template", "1 x 2-5/8 labels", "name badge label size", "which labels for return address"). Searches the supported US Letter label sheets by product number, label size, labels per sheet or use, and returns the layout: label size, columns and rows, top/side margins, pitch and products with the same layout. Does not print labels (use generate_label_sheet) and does not cover A4 sheets or label-maker tape.
| Argument | Type | Description |
|---|---|---|
| kind | string | Use: address, return_address, shipping, name_badge, place_card, file_folder or general. |
| query | string | Product number, size or use, e.g. 8160, "1 x 2-5/8", "30 per sheet", "name badge" or "return address". |
| per_sheet | integer | Labels per sheet, e.g. 30. |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"kind": {
"enum": [
"address",
"return_address",
"shipping",
"name_badge",
"place_card",
"file_folder",
"general"
],
"type": "string",
"maxLength": 40,
"description": "Use: address, return_address, shipping, name_badge, place_card, file_folder or general."
},
"query": {
"type": "string",
"maxLength": 80,
"description": "Product number, size or use, e.g. 8160, \"1 x 2-5/8\", \"30 per sheet\", \"name badge\" or \"return address\"."
},
"per_sheet": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Labels per sheet, e.g. 30."
}
}
}Use this when the user wants to print address labels, mailing labels, return address labels, shipping labels, name badges or name tags, place cards, or file folder labels from a list or a spreadsheet ("avery 5160 template", "print address labels from excel", "mailing labels from excel", "make return address labels", "print christmas card addresses on labels", "start printing at label 7 on a used sheet"). Builds a vector PDF on US Letter that lines up with the chosen label sheet (5160/8160 30 per sheet, 5161, 5162, 5163, 5164, 5168, 5126, 5167, 5195, 5366, 5395, 5390, 22805, 5302 place cards), with USPS address lines, font shrink-to-fit, a start position for partly used sheets, copies per label, return-address fill mode, an optional alignment test page and outlines. Accepts typed labels or an uploaded CSV/XLSX file. Returns a preview, the PDF and a cleaned CSV. Does not buy postage, print USPS shipping labels with postage, make barcodes, or design nutrition labels.
| Argument | Type | Description |
|---|---|---|
| file | object | Optional uploaded mailing list: a CSV, TSV or Excel .xlsx file with one row per label, e.g. contacts.csv or Christmas list.xlsx. Name, address, city, state and ZIP columns are detected from the headings (Google Contacts, Outlook, Etsy and Shopify exports work). |
| kind | string | What the labels are for: address (mailing labels, default), return_address, shipping, name_badge, place_card, file_folder or general text. Sets the default sheet and text style. |
| sort | string | Order of the labels: none (list order, default), zip, name or last_name. |
| align | string | Text alignment: left (default for addresses) or center (default for badges, place cards and square labels). |
| sheet | string | Excel sheet name to read, e.g. Guests. Default: the first sheet with data. |
| copies | integer | Copies of each label, e.g. 2. Default 1. |
| labels | array | The typed or pasted list, one item per label. Either address objects, e.g. [{"name":"Jane Smith","address1":"123 Main St","address2":"Apt 4B","city":"Springfield","state":"IL","zip":"62704"}], or plain text labels with lines separated by \n, e.g. ["Jane Smith\n123 Main St\nSpringfield, IL 62704"]. For name badges use {"name":"Ana Lopez","title":"Engineer","company":"Acme"}. |
| sheets | integer | With fill_sheet: how many full sheets to fill, e.g. 3. Default 1. |
| columns | object | Optional column mapping when the headings are unusual: heading text or column letter per field, e.g. {"name":"Guest","address1":"Mailing Street","zip":"F"}. |
| outline | boolean | Draw a thin grey outline around each label (for printing on plain paper). Default false. |
| start_at | integer | Label position to start on for a partly used sheet, counted left to right then top to bottom, e.g. 7 skips the first 6 labels. Default 1. |
| template | string | Label sheet product number, e.g. 5160 (also 8160, 18160, 5260...), 5163 or 5395. Supported layouts: 5160, 5161, 5162, 5163, 5164, 5168, 5126, 5167, 5195, 5366, 5395, 5390, 22805, 5302. Default by kind: address 5160, return_address 5167, shipping 5163, name_badge 5395, place_card 5302, file_folder 5366. |
| uppercase | boolean | USPS style: all capitals without periods or commas (e.g. SPRINGFIELD IL 62704). Default false. |
| fill_sheet | boolean | Repeat a single label (a return address) to fill the whole sheet. Default true for kind return_address with one label. |
| has_header | boolean | Whether the file's first row is column headings. Default: detected (headings like Name, Address, ZIP or a first row without numbers). |
| max_font_size | number | Largest font size in points; long lines shrink below it to fit, e.g. 12. Default depends on the sheet (11 for 5160). |
| alignment_test | boolean | Add a test page first with each label outlined and numbered, to print on plain paper and hold against a label sheet. With no list, the PDF is only the test page. Default false. |
| bold_first_line | boolean | Print the first line (the name) in bold. Default false for addresses; badges and place cards print the name in bold. |
| include_country | boolean | Also print USA on US addresses that have a country. Default false (non-US countries always print). |
| remove_duplicates | boolean | Print identical labels only once. Default false (duplicates are counted and reported). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string",
"description": "ChatGPT file id, e.g. file_abc123."
},
"file_name": {
"type": "string",
"description": "Original file name if known, e.g. statement.pdf."
},
"mime_type": {
"type": "string",
"description": "Media type if known, e.g. application/pdf."
},
"download_url": {
"type": "string",
"description": "Temporary download link for the file, supplied by ChatGPT."
}
},
"description": "Optional uploaded mailing list: a CSV, TSV or Excel .xlsx file with one row per label, e.g. contacts.csv or Christmas list.xlsx. Name, address, city, state and ZIP columns are detected from the headings (Google Contacts, Outlook, Etsy and Shopify exports work)."
},
"kind": {
"enum": [
"address",
"return_address",
"shipping",
"name_badge",
"place_card",
"file_folder",
"general"
],
"type": "string",
"maxLength": 40,
"description": "What the labels are for: address (mailing labels, default), return_address, shipping, name_badge, place_card, file_folder or general text. Sets the default sheet and text style."
},
"sort": {
"enum": [
"none",
"zip",
"name",
"last_name"
],
"type": "string",
"maxLength": 40,
"description": "Order of the labels: none (list order, default), zip, name or last_name."
},
"align": {
"enum": [
"left",
"center"
],
"type": "string",
"maxLength": 40,
"description": "Text alignment: left (default for addresses) or center (default for badges, place cards and square labels)."
},
"sheet": {
"type": "string",
"maxLength": 60,
"description": "Excel sheet name to read, e.g. Guests. Default: the first sheet with data."
},
"copies": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Copies of each label, e.g. 2. Default 1."
},
"labels": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"maxLength": 600
},
{
"type": "object",
"properties": {
"zip": {
"type": "string",
"maxLength": 20,
"description": "ZIP code, e.g. 62704 or 62704-1234."
},
"city": {
"type": "string",
"maxLength": 100,
"description": "City, e.g. Springfield."
},
"name": {
"type": "string",
"maxLength": 200,
"description": "Recipient or person name, e.g. Jane Smith or The Garcia Family."
},
"state": {
"type": "string",
"maxLength": 60,
"description": "State, e.g. IL or Illinois (converted to the USPS two-letter code)."
},
"table": {
"type": "string",
"maxLength": 60,
"description": "Table number or name for place cards, e.g. 4."
},
"title": {
"type": "string",
"maxLength": 200,
"description": "Job title or second line for badges, e.g. Product Manager."
},
"company": {
"type": "string",
"maxLength": 200,
"description": "Company or organization line, e.g. Acme Corp."
},
"country": {
"type": "string",
"maxLength": 60,
"description": "Country for international mail, e.g. Canada. Leave empty for US addresses."
},
"address1": {
"type": "string",
"maxLength": 200,
"description": "Street address, e.g. 123 Main St. A whole one-line address like \"123 Main St, Springfield, IL 62704\" is split automatically."
},
"address2": {
"type": "string",
"maxLength": 200,
"description": "Apartment, suite or unit, e.g. Apt 4B."
}
}
}
]
},
"maxItems": 10000,
"description": "The typed or pasted list, one item per label. Either address objects, e.g. [{\"name\":\"Jane Smith\",\"address1\":\"123 Main St\",\"address2\":\"Apt 4B\",\"city\":\"Springfield\",\"state\":\"IL\",\"zip\":\"62704\"}], or plain text labels with lines separated by \\n, e.g. [\"Jane Smith\\n123 Main St\\nSpringfield, IL 62704\"]. For name badges use {\"name\":\"Ana Lopez\",\"title\":\"Engineer\",\"company\":\"Acme\"}."
},
"sheets": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "With fill_sheet: how many full sheets to fill, e.g. 3. Default 1."
},
"columns": {
"type": "object",
"properties": {
"zip": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for zip, e.g. \"Postal Code\" or \"F\"."
},
"city": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for city, e.g. \"city\"."
},
"name": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for name, e.g. \"Full Name\" or \"A\"."
},
"state": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for state, e.g. \"state\"."
},
"table": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for table, e.g. \"table\"."
},
"title": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for title, e.g. \"title\"."
},
"company": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for company, e.g. \"company\"."
},
"country": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for country, e.g. \"country\"."
},
"address1": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for address1, e.g. \"address1\"."
},
"address2": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for address2, e.g. \"address2\"."
},
"last_name": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for last_name, e.g. \"last name\"."
},
"first_name": {
"type": "string",
"maxLength": 80,
"description": "Column heading or letter for first_name, e.g. \"first name\"."
}
},
"description": "Optional column mapping when the headings are unusual: heading text or column letter per field, e.g. {\"name\":\"Guest\",\"address1\":\"Mailing Street\",\"zip\":\"F\"}."
},
"outline": {
"type": "boolean",
"description": "Draw a thin grey outline around each label (for printing on plain paper). Default false."
},
"start_at": {
"type": "integer",
"maximum": 80,
"minimum": 1,
"description": "Label position to start on for a partly used sheet, counted left to right then top to bottom, e.g. 7 skips the first 6 labels. Default 1."
},
"template": {
"type": "string",
"maxLength": 40,
"description": "Label sheet product number, e.g. 5160 (also 8160, 18160, 5260...), 5163 or 5395. Supported layouts: 5160, 5161, 5162, 5163, 5164, 5168, 5126, 5167, 5195, 5366, 5395, 5390, 22805, 5302. Default by kind: address 5160, return_address 5167, shipping 5163, name_badge 5395, place_card 5302, file_folder 5366."
},
"uppercase": {
"type": "boolean",
"description": "USPS style: all capitals without periods or commas (e.g. SPRINGFIELD IL 62704). Default false."
},
"fill_sheet": {
"type": "boolean",
"description": "Repeat a single label (a return address) to fill the whole sheet. Default true for kind return_address with one label."
},
"has_header": {
"type": "boolean",
"description": "Whether the file's first row is column headings. Default: detected (headings like Name, Address, ZIP or a first row without numbers)."
},
"max_font_size": {
"type": "number",
"maximum": 48,
"minimum": 6,
"description": "Largest font size in points; long lines shrink below it to fit, e.g. 12. Default depends on the sheet (11 for 5160)."
},
"alignment_test": {
"type": "boolean",
"description": "Add a test page first with each label outlined and numbered, to print on plain paper and hold against a label sheet. With no list, the PDF is only the test page. Default false."
},
"bold_first_line": {
"type": "boolean",
"description": "Print the first line (the name) in bold. Default false for addresses; badges and place cards print the name in bold."
},
"include_country": {
"type": "boolean",
"description": "Also print USA on US addresses that have a country. Default false (non-US countries always print)."
},
"remove_duplicates": {
"type": "boolean",
"description": "Print identical labels only once. Default false (duplicates are counted and reported)."
}
}
}