node-ical Connector for AI agents.
1 live capability
Analyze your exported calendar files to find free time and summarize your week.
Waiting for input…
Why people use node-ical
ICal Calendar Parser for Private Schedule Analysis
With this Connector, you just export your calendar once. Your agent can then read that file to find gaps, count meetings, and summarize your week. You get a clear view of your availability without the manual labor.
What Vinkius changes
You turn a static calendar file into a searchable schedule for your AI.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Finding a gap for a call
You tell your agent you need a 30-minute window tomorrow.
- Real-world use case 02
Meeting audits
You ask how many times you met with the marketing team this month.
- Real-world use case 03
Travel prep
You want to see your itinerary for a trip.
Complete set · 1capability
The complete node-ical capability set.
These are the exact actions your AI can choose when you ask it to work with node-ical.
01
1 capability in this set.
Part of 1 available through node-ical.
- 01 Capability
Parse ical calendar
Converts a local .ics file into structured JSON data. It lets your agent see every event in your calendar at once.
Set up in minutes
One URL. Then ask node-ical to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use node-ical from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_4PT3Yytl5zPBxGK1zMfW8ZpFW5MiZ7ZbdQsMHlDv/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it node-ical, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable node-ical for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_4PT3Yytl5zPBxGK1zMfW8ZpFW5MiZ7ZbdQsMHlDv/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the node-ical URL.
- Step 03
Save and start
Save the connection and enable node-ical in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"ical-calendar-parser": {
"url": "https://edge.vinkius.com/vk_preview_4PT3Yytl5zPBxGK1zMfW8ZpFW5MiZ7ZbdQsMHlDv/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using node-ical
Open Agent mode in chat and ask: "Using node-ical, help me...". 1 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"ical-calendar-parser": {
"url": "https://edge.vinkius.com/vk_preview_4PT3Yytl5zPBxGK1zMfW8ZpFW5MiZ7ZbdQsMHlDv/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using node-ical
Ask Copilot: "Using node-ical, help me...". 1 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"ical-calendar-parser": {
"url": "https://edge.vinkius.com/vk_preview_4PT3Yytl5zPBxGK1zMfW8ZpFW5MiZ7ZbdQsMHlDv/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using node-ical
Open Cascade and ask: "Using node-ical, help me...". 1 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"ical-calendar-parser": {
"url": "https://edge.vinkius.com/vk_preview_4PT3Yytl5zPBxGK1zMfW8ZpFW5MiZ7ZbdQsMHlDv/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using node-ical
Ask Cline: "Using node-ical, help me...". 1 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add ical-calendar-parser --transport http "https://edge.vinkius.com/vk_preview_4PT3Yytl5zPBxGK1zMfW8ZpFW5MiZ7ZbdQsMHlDv/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using node-ical
Ask Claude: "Using node-ical, show me...". 1 tools are ready
Where the request belongs
Work node-ical can move forward.
This is for anyone who needs their AI to understand their schedule but doesn't want to grant it full access to their live calendar accounts. It's perfect for people who value privacy or work across multiple different calendar platforms.
Freelance Consultant
Uses the Connector to find gaps in a packed schedule to book new client discovery calls.
Project Manager
Analyzes a week's worth of meetings to see where the team is spending the most time.
Privacy-Conscious User
Keeps their personal schedule local and only shares the specific data they want the AI to see.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsCronofy
Automate scheduling via Cronofy. unify Google, iCloud, and Exchange calendars to manage events and track multi-user availability directly from any AI agent.
Google Calendar
Sync and orchestrate your agenda securely. scan, schedule, and manipulate Google Calendar events natively in chat.
Fantastical
Manage calendars via Fantastical. create events using natural language, handle scheduling openings and proposals, and monitor connected accounts directly from any AI agent.
iCalendar RRULE Iterator
Expand iCalendar recurrence rules into exact, deterministic event sequences.
Truto Unified Calendar
Empower your AI agent with a universal API to read, schedule, and sync events seamlessly across Google, Outlook, and other major calendar providers.
Cal.com
Manage your scheduling via Cal.com. track bookings, manage event types, and coordinate meetings directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep node-ical connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about node-ical.
The practical details behind the request, access and result.
How does the iCal Calendar Parser protect my privacy?
It keeps your data local. Instead of connecting your AI to a live cloud account, it reads a file on your machine. Your schedule stays private unless you choose to share that specific file.
Can I use iCal Calendar Parser with my Google Calendar?
Yes. You just need to export your Google Calendar as an .ics file. Once you have that file, the Connector can read it to help you manage your time.
Does the iCal Calendar Parser work with Outlook?
It works with any standard .ics export, which includes Outlook. Just export your calendar and provide the file path to your agent.
Will my AI agent see my meetings in real-time?
This Connector reads a snapshot of your calendar. If you add a new meeting, you'll need to export the updated .ics file for your agent to see it.
What happens if I have more than 200 events?
The Connector is optimized to handle up to 200 events at a time. For very large calendars, it's best to export a specific date range, like your upcoming month.
Can the iCal Calendar Parser find free slots for me?
Yes. Once the Connector reads your file, your agent can look for gaps between events and tell you exactly when you're available for new appointments.
How do I export my Google Calendar?
Go to calendar.google.com > Settings > Import & Export > Export. It downloads a .zip containing .ics files for each calendar.
Can it detect scheduling conflicts?
Yes! Because events are sorted chronologically with start/end times, the AI can easily spot overlapping events and alert you.
Does it include recurring events?
Yes, the parser expands recurring events according to the iCal RRULE specification, so each individual occurrence appears as its own entry.
One connection away
Give your agent a direct line to node-ical.
Connect node-ical once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available