Home / Servers / Stripe API / post_invoices_invoice

Update an invoice

An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.

Update an invoice Draft invoices are fully editable. Once an invoice is finalized , you can no longer change most of its details, including monetary values and collection_method . For most invoices, this also… [POST /v1/invoices/{invoice}]

Name on the gateway: stripe_api__post_invoices_invoice · may change things.

Parameters

NameTypeDescription
invoice requiredstringinvoice parameter
account_tax_idsarrayThe account tax IDs associated with the invoice. Only editable when the…
application_fee_amountintegerA fee in cents (or local equivalent) that will be applied to the invoice and…
auto_advancebooleanControls whether Stripe performs automatic collection of the invoice.
automatic_taxobjectSettings for automatic tax lookup for this invoice.
automatically_finalizes_atintegerThe time when this invoice should be scheduled to finalize (up to 5 years in…
collection_methodcharge_automatically | send_invoiceEither charge_automatically or send_invoice. This field can be updated only on…
custom_fieldsarrayA list of up to 4 custom fields to be displayed on the invoice. If a value for…
days_until_dueintegerThe number of days from which the invoice is created until it is due. Only…
default_payment_methodstringID of the default payment method for the invoice. It must belong to the…
default_sourcestringID of the default payment source for the invoice. It must belong to the…
default_tax_ratesarrayThe tax rates that will apply to any line item that does not have tax_rates…
descriptionstringAn arbitrary string attached to the object. Often useful for displaying to…
discountsarrayThe discounts that will apply to the invoice. Pass an empty string to remove…
due_dateintegerThe date on which payment for this invoice is due. Only valid for invoices…
effective_atintegerThe date when this invoice is in effect. Same as finalized_at unless…
expandarraySpecifies which fields in the response should be expanded.
footerstringFooter to be displayed on the invoice.
issuerobjectThe connected account that issues the invoice. The invoice is presented with…
metadataobjectSet of key-value pairs that you can attach to an object. This can be useful…
numberstringSet the number for this invoice. If no number is present then a number will be…
on_behalf_ofstringThe account (if any) for which the funds of the invoice payment are intended.…
payment_settingsobjectConfiguration settings for the PaymentIntent that is generated when the…
renderingobjectThe rendering-related settings that control how invoices render in…
shipping_costobjectSettings for the cost of shipping for this invoice.
shipping_detailsobjectShipping details for the invoice. The Invoice PDF will use the…
statement_descriptorstringExtra information about a charge for the customer's credit card statement. It…
transfer_dataobjectIf specified, the funds from the invoice will be transferred to the…

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "stripe_api__post_invoices_invoice",
  "arguments": {
    "invoice": "…"
  }
}

Or connect the Stripe API server directly, which lists 606 tools including this one:

Run in your terminal
claude mcp add --transport http hj-stripe-api https://mcp.hjlabs.in/mcp/stripe-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the update an invoice tool with invoice set to ….

More from Stripe API