How to Use the Tomorrow.io MCP in Claude Code

Q: How can Tomorrow.io run in a headless environment with Claude Code?

You define the connection using claude mcp add and write your script to call the tools directly via standard input/output (stdio). The entire process runs without needing any graphical interface.

Q: What kind of tasks can I automate with Tomorrow.io and Claude Code?

You can automate complex data ingestion, such as running gethistoricalweather to pull annual weather logs for compliance checks, or running a daily forecast check using getdailyforecast.

Q: Can I use Tomorrow.io for predictive modeling in CI/CD with Claude Code?

Yes. You can script calls to gethourlyforecast and pipe the raw predictions into a data processing tool within your pipeline, allowing you to validate time-series data automatically.

Run automated weather checks in CI/CD pipelines. Claude Code executes Tomorrow.io tasks headless.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Tomorrow.io MCP to Claude Code

Create your Vinkius account to connect Tomorrow.io to Claude Code and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Tomorrow.io with Claude Code

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate daily data ingestion

Need to check the forecast every night? Write a simple shell script that calls `get_daily_forecast` and pipes the output into a log file. Claude Code executes this in headless mode, making it perfect for cron jobs. It also handles long-term planning by executing scripts against `get_custom_timelines`, allowing you to validate complex weather requirements without needing an active GUI.

Build automated risk reporting

Automate safety checks for infrastructure. A script can call `get_wildfire_risk` and then `get_road_weather_risk`, processing the output to generate a binary PASS/FAIL status code that other pipeline tools consume. This process is repeatable, making it ideal for CI/CD pipelines where consistent environmental checks are mandatory.

Execute real-time data checks

Need to validate current conditions before deployment? Write a script that uses `get_realtime_weather` with specific coordinates. The output can then be used by other tools in the pipeline, like checking air quality using `get_air_quality_index`. This capability lets you build robust checks into your automation workflow that rely on accurate, current environmental metrics.

Setup guide

Set up Tomorrow.io MCP in Claude Code

Prerequisites

Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
Active Vinkius subscription with a valid endpoint token

1

Run the add command

Open your terminal and run the command shown on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com. Use --scope user to make it available across all projects.
2

Verify the connection

Start a Claude Code session and type /mcp to list connected servers. You should see tomorrowio-mcp with a green status indicator.
3

Start using tools

Ask Claude Code something like "Check my latest Tomorrow.io transactions." It will automatically discover and invoke the available Tomorrow.io tools.

Terminal

claude mcp add --transport http tomorrowio-mcp https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Get your connection token →

Prerequisites

Claude Code CLI installed
Active Vinkius subscription with a valid endpoint token

1

Open the config file

Create or edit .mcp.json in your project root for project-level scope, or ~/.claude.json for user-level scope.
2

Add the Tomorrow.io MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Code

Start a new Claude Code session. Type /mcp to confirm the server is connected. The tools will be automatically available in your conversation.

.mcp.json

{
  "mcpServers": {
    "tomorrowio-mcp": {
      "type": "url",
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Tomorrow.io. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Tomorrow.io now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Tomorrow.io MCP in Claude Code

You define the connection using `claude mcp add` and write your script to call the tools directly via standard input/output (stdio). The entire process runs without needing any graphical interface.

You can automate complex data ingestion, such as running `get_historical_weather` to pull annual weather logs for compliance checks, or running a daily forecast check using `get_daily_forecast`.

Yes. You can script calls to `get_hourly_forecast` and pipe the raw predictions into a data processing tool within your pipeline, allowing you to validate time-series data automatically.

Absolutely. You can set up scheduled jobs that check key metrics like air quality (`get_air_quality_index`) or pollen levels using `get_pollen_forecast`, and then email a failure report if thresholds are crossed.

The server provides weather data, including current conditions, historical observations, risk assessments (wildfire/road), and highly granular minute-by-minute precipitation nowcasts.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript