Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint · rollforge · bestiary · statline · matchpoint · retail · agentops · browserworkflow · modelrouter · compose
$ man csv-to-ics

/csv-to-ics

agentutility / mediakit / csv-to-ics
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
mediakit
CATEGORY
utilities
STATUS
● live
NAME
csv-to-ics — converts a csv of events into an rfc 5545 compliant ics calendar file (vcalendar/vevent) for google calendar, outlook, and apple calendar…
SYNOPSIS
POST https://x402.agentutility.ai/csv-to-ics
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

Converts a CSV of events into an RFC 5545 compliant ICS calendar file (VCALENDAR/VEVENT) for Google Calendar, Outlook, and Apple Calendar import. Auto-detects column mapping (summary, date, time, location, description) or accepts an explicit mapping; handles all-day and timed events, configurable default duration, and custom delimiters. Up to 1000 rows. Use it as a CSV to iCal converter, calendar file generator, or .ics builder.

INPUT — request schema
propertytypedescriptionreq?
csvstringRaw CSV text. First row is treated as the header unless overridden. Up to 1000 data rows.required
columnsobjectOptional explicit column mapping, e.g. { summary: 'Title', start_date: 'Date', start_time: 'Time', location: 'Where', description: 'Notes' }. Auto-detected from header names when omitted.optional
calendar_namestringX-WR-CALNAME shown by calendar clients. Default 'Schedule'.optional
default_duration_minutesnumberEvent duration in minutes when no end time/date is provided. Default 60.optional
delimiterstringCSV delimiter character. Default ','. Use '\t' for TSV, ';' for European CSV, '|' for pipe-delimited.optional
OUTPUT — response shape
fieldtypedescription
icsstringFull .ics file as a string.
mime_typestringMIME type of the generated file, typically text/calendar for ICS output.
event_countnumberNumber of VEVENT entries successfully written to the ICS file.
skipped_rowsnumberCount of CSV rows skipped due to missing required fields or unparseable dates.
errorsarrayArray of per-row error messages describing why specific rows failed to convert.
calendar_namestringX-WR-CALNAME value set on the calendar, derived from CSV header or filename.
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/csv-to-ics \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the csv-to-ics tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
csvicscalendaricalconvertevents
methods
POST
cluster
mediakit
price
$0.01 USDC per call
ADJACENT — other endpoints in mediakit
endpointdescriptionprice
audio-transcribeTranscribes audio to text with whisper-large-v3.$0.01
image-convertConvert an image from one format to another.$0.01
image-format-convertImage converter.$0.01
merge-pdfCombines two to fifty separate PDF files into one, taking each source as a URL and stitching them together in the order supplied, bookmar…$0.01
movie-databaseFinds movies or TV shows by title, with optional year and region, and returns release year, poster, overview, and language.$0.01
movie-database-apiSearches movies and TV shows by title and optional year, returning release date, rating, popularity, overview, poster URLs, TMDB links, a…$0.01
movie-infoLooks up movie and TV metadata: title, release year, rating, overview, poster, and optional streaming providers.$0.01
pdf-mergeJoins multiple PDF files, hosted at URLs, into a single ordered document, so you don't have to merge them by hand in a desktop PDF editor.$0.01
SEE ALSO
agentutility · mediakit · x402 · mcp · llms.txt · registry.json · bazaar.x402.org