Back to MCP

MCP guides · Sep 15, 2026

Create a Cursor cron job for an HTTP endpoint in 5 minutes

Connect Cursor to Crontap, schedule a weekday request to an endpoint you control, and verify the saved job without leaving the editor.
crontap.com / mcp guides
Create a Cursor cron job: connect Cursor to Crontap MCP, schedule a weekday HTTP request, verify its next run, add a cron job to an app built with Cursor, and learn when Cursor Automations are the better clock.

As of 2026-11-11, the native way to run a Cursor cron job is Cursor Automations: cloud agents that run a prompt on a preset or cron schedule, or when an event arrives from GitHub, Slack, Linear, a webhook, and more. Free and Plus plans do not include them. Automations run agent prompts, so they do not give your own endpoint a recurring HTTP request with retries, run history and failure alerts. Connect Crontap's MCP server and Cursor can create, inspect, and pause that HTTP schedule from chat, while Crontap sends each request whether or not Cursor is open.

You have a /daily-digest route and want it called every weekday at 9:00 AM. This walkthrough connects Cursor to Crontap, creates the recurring HTTP request, and verifies the saved schedule in about five minutes. You need a Crontap account, a public HTTPS endpoint that is safe to call more than once, and a current Cursor desktop installation.

Before you create a Cursor cron job

  • Choose the timezone that describes 9:00 AM for your users. This example uses Europe/London.
  • Keep endpoint secrets in request headers. Do not paste production secrets into the chat transcript.
  • Cursor supports remote Streamable HTTP servers with OAuth. Project config lives at .cursor/mcp.json; global config lives at ~/.cursor/mcp.json.
  • Verified against the Cursor MCP docs, Cursor Automations docs, and cloud agent docs on 2026-11-11.

Connect Cursor to Crontap MCP

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "crontap": {
      "url": "https://mcp.crontap.com/mcp"
    }
  }
}

Cursor IDE supports remote OAuth MCP servers and a one-click deeplink.

The selected setup points Cursor at https://mcp.crontap.com/mcp. A project file shares the server definition with collaborators, while the global file keeps it private to your machine. Either way, Cursor opens Crontap OAuth in your browser when authentication is needed.

Step 1

Add the remote server

Put the configuration in .cursor/mcp.json for this repository or ~/.cursor/mcp.json for every project. Crontap should appear under Customize with its schedule, monitor, heartbeat, and account tools.

Step 2

Approve the connection

Open Crontap in Cursor's MCP list and complete the browser sign-in. Review the requested access before approving it. The server should change to connected, with its tools available in chat.

Cursor MCP servers
Crontap
Connected
Authentication
OAuth 2.1

Step 3

Preview the weekday cadence

Ask Cursor to preview “weekdays at 9am” in Europe/London without saving it. Previewing first catches timezone or cadence ambiguity before a write. Cursor should call preview_schedule and show the resolved cron expression, timezone, and next run times.

Step 4

Create the HTTP schedule

Ask Cursor to create a POST schedule for https://example.com/daily-digest using the previewed cadence. If your endpoint requires authentication, tell Cursor to leave the secret out. After creation, open the returned schedule on the Crontap schedule page, add the Authorization request header there, save it, and perform a test request. Cursor presents the schedule write for approval, then returns the new schedule ID and next run.

Step 5

Read it back before you leave

Ask Cursor to list schedules and retrieve the new item by its returned ID. Check the URL, method, cadence, timezone, and status. The saved schedule should be active and match the preview. Pause it immediately if any field is wrong.

Create the Cursor cron job with copyable prompts

The prompts below keep reads and writes separate, which makes approvals easier to review.

Use only the Crontap MCP tools. Preview "weekdays at 9am" in Europe/London. Do not create or update anything yet. Show the resolved cron and three upcoming runs.
Create a schedule named "weekday daily digest" that POSTs to https://example.com/daily-digest using the cadence we just previewed. Before calling create_schedule, summarize the URL, method, timezone, and cadence for my approval.
List my Crontap schedules, find "weekday daily digest", retrieve it by ID, and confirm its status and next run. Do not modify it.

Verify the Cursor cron job worked

First, verify the MCP response. The create call should return one schedule ID, an active status, and a next run consistent with the preview. Then open Crontap and inspect the same resource. Confirm that the endpoint is exactly the production URL, not a local or preview deployment.

After the first scheduled fire, ask Cursor to call get_schedule_history for that ID. A successful entry should show an HTTP success status and duration. Also check the endpoint's own logs for the matching request. Crontap history proves the request left the scheduler; application logs prove your route handled it.

If you need evidence before 9:00 AM, temporarily create a safe test schedule with a near-term cadence, verify one run, then delete it. Do not change the production schedule just to force a test.

Add scheduled tasks or cron jobs to an app built with Cursor

Cursor writes and edits the code, but it does not host your deployed app or call its routes on a timer. To give a Cursor-built app a cron job, turn the work into an HTTP route (for example POST /api/cron/daily-digest), protect it with a secret header, make it safe to run twice, and deploy it. Then point an external schedule at that URL. You can ask Cursor to write the route, and create the schedule from the same chat with the steps above.

Cursor Automations do not replace this step: they run agent prompts in Cursor's cloud, not your deployed app's routes. For per-platform details and three reusable URL shapes, read Scheduled tasks for AI-built apps.

Cursor Automations or a Crontap cron job?

Use a Cursor Automation when the recurring work is a cloud agent prompt, such as reviewing pull requests every morning. Use Crontap when the recurring work is an HTTP request to an API, webhook, or cloud function. Last verified 2026-11-11 against Cursor's docs.

QuestionCursor AutomationsCrontap schedule
What firesA cloud agent promptAn HTTP request to your URL
TriggersSchedule, Git, Slack, webhook, moreCron schedule in an IANA timezone
PlansPremium and up, Teams, EnterpriseEvery Crontap plan
BillingCloud agent usageYour Crontap plan
Retries and failure alertsNot documented for an HTTP callRetries 5xx and timeouts, then alerts

Scheduled Automations take a preset or a cron expression, and Cursor notes they may run with a delay but will not start before the indicated time. Other triggers include GitHub, GitLab, and Bitbucket Cloud, Slack, webhooks, Linear, Sentry, and PagerDuty. You create one in the Agents Window, at cursor.com/automations, with the /automate skill, or from a Marketplace template. Cloud agents need Premium and higher, Teams, Enterprise, or a legacy paid plan; Free and Plus do not include them.

A Crontap schedule runs independently of whether Cursor is open, records status, status code, duration, and error per run, and sends email failure alerts on every plan, with Slack, Discord, and Telegram on paid plans. For “tell me when an existing worker stopped checking in,” use a Crontap heartbeat. The worker sends pings; Crontap alerts when they stop.

Troubleshoot a Cursor cron job

Crontap never appears in Cursor

Check that the JSON uses mcpServers, that the URL ends in /mcp, and that the file is in .cursor/mcp.json or ~/.cursor/mcp.json. Open Customize and make sure the server is enabled.

OAuth opens but connection fails

Retry authentication from the server entry, and read the MCP Logs channel in the Output panel (Cmd+Shift+U). Corporate proxies must allow the MCP host and browser OAuth redirects. Cursor's desktop OAuth callback uses localhost, so software that blocks loopback callbacks can interrupt sign-in.

Cursor cannot find a schedule

Ask it to call list_schedules first. Similar names are easy to mix up; confirm the ID and endpoint before approving a change.

The run returned 401 or 403

The scheduler reached your endpoint, but endpoint authentication rejected it. Check the header name and value at the endpoint. Do not paste the secret into another prompt while debugging.

The endpoint ran twice

Make the endpoint idempotent. Retries and manual tests can repeat requests. Use a date or request key so a digest, invoice, or cleanup operation can safely ignore duplicates.

Next steps

If /daily-digest is already deployed, create the weekday schedule from Cursor with the prompts above, add the Authorization header on the schedule page, and run a test before 9:00 AM. Schedule your first job →

Verified against current Cursor MCP, Automations, and cloud agent documentation on 2026-11-11. Sources: Cursor MCP, Cursor Automations, and Cursor cloud agents.

FAQ

Cursor cron job questions

Can Cursor run cron jobs?
Cursor can use Crontap MCP to create and manage recurring HTTP requests. Cursor Automations are the separate native option: they run cloud-agent prompts on a preset or cron schedule, or on events, billed as cloud-agent usage on Premium and higher, Teams, and Enterprise plans.
How do I add scheduled tasks or cron jobs to an app built with Cursor?
Expose the job as an HTTP route, protect it with a secret header, make it safe to run twice, and deploy it. Then point an external schedule such as Crontap at the URL. Cursor Automations run agent prompts, not your deployed app's routes.
Where does Cursor store MCP configuration?
Use .cursor/mcp.json for project configuration or ~/.cursor/mcp.json for a global configuration available across projects.
Does Crontap wake a Cursor agent?
No. Crontap owns the clock for HTTP requests. Cursor initiates MCP tool calls while you are chatting, and Cursor Automations own scheduled cloud-agent runs.
How do I debug a Cursor MCP connection?
Open the Output panel with Cmd+Shift+U or Ctrl+Shift+U, choose MCP Logs, and check authentication, connection, or tool-discovery errors.

From the blog

Read the blog

Guides, patterns and product updates.

Tutorials on scheduling API calls, webhooks and automations, plus deep dives into cron syntax, timezones and reliability.

Product

Introducing Crontap status pages

Publish uptime monitors and heartbeats on a public page at crontap.page, pick a template from Clean to a split-flap departures board, and add incidents, maintenance and a badge.

Product Updates

Introducing AI Integrations

Transform a schedule's HTTP response with a plain-English prompt, return text or JSON, and forward it to Slack, Make, n8n, or your own endpoint. Test on any tier; saving is a Pro feature.

Alternatives

Vercel cron jobs: the Hobby once-per-day limit and how to beat it

Vercel Cron caps Hobby at one run per day, only guarantees timing within the hour, is UTC only, and ties every schedule change to a redeploy. Here is the external cron pattern teams use to ship per-minute, timezone-aware schedules and one dashboard across projects without paying $20/mo per user for Pro.