[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# Sunsama MCP server: Let your AI agent plan your day in Sunsama.

> Sunsama runs an official MCP server at api.sunsama.com/mcp with OAuth sign-in, and the beta ended on 27 Aug 2026. It has no documented public REST API (checked 6 Nov 2026). Cotlet adds 14 Sunsama tools that need no API key or developer setup, work inside the ChatGPT and Claude apps and run hosted around the clock, with REST for scripts and one account for your other apps.

Your AI agent pulls backlog tasks into today, timeboxes them on the calendar and logs the actual time when you finish. Sign in to Sunsama once in your own Cloud Browser. Sunsama also runs its own MCP server; Cotlet adds documented tools, REST for n8n and scripts, and one account for your other apps.

- Free 7-day trial, no card
- Independent, not affiliated with Sunsama
- Page: https://cotlet.dev/integrations/sunsama-api-mcp-server

## What can your AI agent do in Sunsama?

- Pull backlog tasks into today
- Timebox the day on the calendar
- Log actual time at the end of the day
- Turn weekly objectives into daily tasks
- Capture tasks from meeting notes
- Set up weekly routines

## Does Sunsama have an MCP server or an API?

- Sunsama lists MCP in its Pro plan, $17 a month billed yearly or $22 billed monthly. Its help page covers ChatGPT, Claude, Cursor, Claude Code and Notion, and lists no tools.
- Sunsama staff said in 2026 that an agent can start and stop the timer and see the active task, and that actual time records were not yet exposed (24 Jun 2026).
- The API request on Sunsama's roadmap is open since December 2019. Zapier lists the actions Create Task, Update Task, Find Task, Find or Create Task and Find Channel.

| What you need | Official Sunsama MCP | Zapier app | Cotlet |
|---|---|---|---|
| Works in the ChatGPT and Claude apps | Yes | Through Zapier MCP | Yes |
| Tools documented with inputs | No list on the help page | Yes, listed actions | Yes, 14 tools |
| Timebox a task on the calendar | Yes, per Sunsama staff | Not listed | Yes |
| Log actual time on a task | Not exposed, 24 Jun 2026 | Not listed | Yes |
| Call it from a script or n8n | MCP clients only | Yes, in a Zap | Yes, REST |
| One account for other apps too | Sunsama only | Per app in Zapier | Yes |

Checked 6 Nov 2026. Sources: [Sunsama User Manual: MCP (Model Context Protocol)](https://help.sunsama.com/docs/integrations/mcp/), [Sunsama roadmap: Sunsama API](https://roadmap.sunsama.com/improvements/p/sunsama-api), [Sunsama roadmap: MCP Server](https://roadmap.sunsama.com/integrations/p/mcp-server), [Zapier: Sunsama integrations](https://zapier.com/apps/sunsama/integrations), [Sunsama pricing](https://www.sunsama.com/pricing)

## How does the Sunsama MCP server work?

1. **Sign in to Sunsama.** Once, in a browser we host for you.
2. **Connect your AI agent.** Add one address to its settings.
3. **Ask about your day.** It plans, timeboxes and logs.

We never keep your Sunsama password, and no tool touches your plan, billing or workspace members.

## How to connect Sunsama to your AI agent

1. **Enable Sunsama for agents.** Make a Cotlet account, sign in to Sunsama in its Cloud Browser and press Enable for agents.
2. **Add the Cotlet address.** Enter https://cotlet.dev/mcp/v1 as an MCP server or custom connector in your agent.
3. **Approve the connection.** Chat apps open a Cotlet sign-in page. Code editors, n8n and scripts send an API key you create in the console.

One address, `https://cotlet.dev/mcp/v1`, carries Sunsama next to your other apps. The tools work in the Sunsama account signed in to the Cloud Browser. Enabled Sunsama after connecting? Refresh the connector to load the new tools.

Claude:

```
Settings > Connectors > Add custom connector
URL: https://cotlet.dev/mcp/v1/connect

Claude Code:
claude mcp add --transport http cotlet-sunsama \
  https://cotlet.dev/mcp/v1 \
  --header "Authorization: Bearer $COTLET_API_KEY"
```

ChatGPT:

```
Settings > Apps & Connectors > Create
MCP server URL: https://cotlet.dev/mcp/v1/connect
Authentication: OAuth
```

Cursor:

```
// ~/.cursor/mcp.json
{
  "mcpServers": {
    "cotlet-sunsama": {
      "url": "https://cotlet.dev/mcp/v1",
      "headers": { "Authorization": "Bearer ${env:COTLET_API_KEY}" }
    }
  }
}
```

Codex:

```
# ~/.codex/config.toml
[mcp_servers.cotlet-sunsama]
url = "https://cotlet.dev/mcp/v1"
bearer_token_env_var = "COTLET_API_KEY"
```

n8n:

```
MCP Client Tool (inside an AI Agent)
Transport: HTTP Streamable
URL: https://cotlet.dev/mcp/v1
Auth: Bearer, <your key>
Tool: sunsama_read
```

Make, Zapier:

```
Make: MCP Client > Call a tool
Zapier: MCP Client by Zapier > Run Tool
Server URL: https://cotlet.dev/mcp/v1
Token: <your key>
Tool: sunsama_write
```

## All 14 Sunsama MCP tools

### Tasks and subtasks

create_task without a date files the task in the backlog, and a channel that does not exist fails at once. Moving a task to another day removes its working session.

- **List tasks for a day** (`list_tasks`, read): Lists the tasks planned for one day, with channel, planned time and status.
- **Get a task** (`get_task`, read): Returns one task with its notes, subtasks, times and objective.
- **Create a task** (`create_task`, write): Creates a task on a day or in the backlog.
- **Update a task** (`update_task`, write): Changes the title, notes, channel or planned time of a task.
- **Add a subtask** (`add_subtask`, write): Adds a subtask to a task.
- **Complete a task** (`complete_task`, write): Marks a task as complete, or reopens it.
- **Move a task to a day or the backlog** (`move_task`, write): Moves a task to another day or into the backlog.

### Backlog and channels

The backlog comes in pages: call again with next_cursor until it is empty. Read the channels before creating a task.

- **List backlog tasks** (`list_backlog_tasks`, read): Lists the tasks in your someday backlog.
- **List channels** (`list_channels`, read): Lists your channels and the contexts they belong to.

### Calendar and time

A timebox sets the task's planned time. Actual time replaces any earlier value, so log it once at the end.

- **Timebox a task on the calendar** (`timebox_task`, write): Adds a working session for a task to the calendar.
- **Log actual time** (`set_actual_time`, write): Records how long a task actually took.

### Repeats and weekly objectives

Set channel, notes and estimate before you set a repeat, because every future instance copies them.

- **Set a task to repeat** (`set_task_repeat`, write): Makes a task repeat on weekdays or on chosen days of the week.
- **List weekly objectives** (`list_objectives`, read): Lists the weekly objectives of one week with the tasks aligned to each.
- **Align a task with an objective** (`align_task_with_objective`, write): Links a task to a weekly objective.

Inputs, REST path and example response of every tool: https://cotlet.dev/integrations/sunsama-api-mcp-server#tools

## Who can see my Sunsama session, and how do I revoke it?

- **What we store.** Your signed-in Sunsama profile, AES-256-GCM encrypted, in Finland. Never the password.
- **What your agent gets.** The 14 Sunsama tools. No cookie, no login method.
- **What the session sees.** Your tasks, backlog, channels, calendar sessions and objectives.
- **What no tool touches.** Your plan, billing, password, workspace members and deleting.
- **If Sunsama signs you out.** You get an email and a sign-in link. We never sign in for you.
- **How to cut access.** Disable for agents, reset the browser or delete the API key.

Our site gets A+ on Qualys SSL Labs, securityheaders.com and Mozilla Observatory ([live results](https://cotlet.dev/security.md)). We have no SOC 2 report or third-party pentest yet.

## What happens when Sunsama changes?

- **12 h** between tests of the Sunsama tools
- **$0** for a call to a Sunsama tool paused for repair

Sunsama opened its MCP server in April 2026 and closed the beta on 27 Aug 2026, so the product moves quickly. When a button or the calendar view changes, we fix the tool and your prompts keep working. [status.cotlet.dev](https://status.cotlet.dev) checks the site, console and API every 3 minutes.

## Undo and mistakes

1. **Reads your day.** Tasks, planned minutes and channels, so IDs are real.
2. **Estimates.** Sets a planned time on each task that has none.
3. **Timeboxes.** Adds a working session on the calendar in list order.
4. **Reports back.** Start, end and planned minutes for each task.

| Action | Undo |
|---|---|
| Create a task or subtask | Delete it in Sunsama |
| Update a task | Call update_task again with the old values |
| Complete a task | Call complete_task with completed set to false |
| Move a task | Move it back, then timebox it again |
| Timebox a task | Timebox it again with a new time |
| Log actual time | Call set_actual_time again, it replaces the value |
| Set a repeat | Call set_task_repeat with none |

None of the 14 tools waits for your OK: every write lands in your own Sunsama and reaches no one else. Scheduled runs need no approval.

> A task moved to the wrong day is one call from being right. Ask the agent to put it back.

MCP call:

```
{
  "name": "timebox_task",
  "arguments": {
    "task_id": "task_8f31c9",
    "date": "2026-11-06",
    "start_time": "10:00",
    "duration_minutes": 45
  }
}
```

REST:

```
curl -X POST https://cotlet.dev/api/v1/sunsama/tasks/task_8f31c9/timebox \
  -H "Authorization: Bearer $COTLET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"2026-11-06","start_time":"10:00","duration_minutes":45}'
```

Tool output:

```
{
  "task_id": "task_8f31c9",
  "date": "2026-11-06",
  "start_time": "10:00",
  "end_time": "10:45",
  "planned_minutes": 45
}
```

Scripts and cron jobs reach the same tools over REST, with the same key and price. A failed call costs nothing. Each row in the tools list shows its REST path.

## How much does the Sunsama MCP server cost?

**About $34 a month** for one person planning every workday with an agent, 5,940 credits. Your Sunsama plan is billed by Sunsama as before.

| Job | Calls | Credits |
|---|---|---|
| Pull backlog tasks into today | 5 × 20 | 1,000 |
| Timebox the day on the calendar | 6 × 20 | 1,200 |
| Log actual time and complete tasks | 7 × 20 | 1,400 |
| Weekly objectives into daily tasks | 9 × 4 | 360 |
| Tasks from meeting notes | 6 × 8 | 480 |
| Cloud Browser, 30 days |  | 1,500 |
| Total |  | 5,940 |

- Free 7-day trial, no card
- 10 credits per successful call, MCP or REST
- 50 credits a day for the Cloud Browser
- Your own Sunsama plan, with its 14-day trial

The month is our example, since Sunsama publishes no usage figures: 20 workdays with a plan, a timebox pass and an end-of-day log, four weekly objective runs, eight meeting captures. Sunsama Pro costs $17 a month billed yearly or $22 billed monthly (sunsama.com/pricing, 6 Nov 2026). Dollars at the $29 pack rate.

## Sunsama MCP server: official, GitHub or hosted

| Option | What it does | Where it stops |
|---|---|---|
| [Official Sunsama MCP](https://help.sunsama.com/docs/integrations/mcp/) | api.sunsama.com/mcp, OAuth, for ChatGPT, Claude, Cursor, Claude Code and Notion. Included in Pro. | MCP clients only, no documented REST API, no published tool list. Actual time records were not exposed on 24 Jun 2026. |
| [robertn702/mcp-sunsama](https://github.com/robertn702/mcp-sunsama) | MIT, 52 stars. Tasks, subtasks, backlog and streams. | Archived, last push 1 Mar 2026. Runs on your computer. |
| [robertn702/sunsama-relay](https://github.com/robertn702/sunsama-relay) | A self-hosted REST relay for n8n and scripts, 12 stars. | You host it. No licence, last push 15 Jan 2026. |
| [n8n-nodes-sunsama](https://github.com/gabepaez/n8n-nodes-sunsama) | A community n8n node for tasks, streams, subtasks and calendar, version 0.1.1. | 33 downloads in the last month, last published 26 Feb 2026. |
| [Zapier](https://zapier.com/apps/sunsama/integrations) | Actions Create Task, Update Task, Find Task, Find or Create Task and Find Channel. | No timeboxing or actual time in its action list. |
| [Open Sunsama](https://github.com/kaijiabo/open-sunsama) | A separate open-source planner with its own MCP and REST API, 138 stars. | You move your planning off Sunsama. |

If you plan in Claude or ChatGPT and your Pro plan covers MCP, start with the official server. Cotlet is for REST from n8n or a script, documented tools with example responses, actual time on a task and one account for your other apps.

## Who runs Cotlet

Cotlet belongs to Take Group sp. z o.o., a software company registered in Poland, EU (VAT PL6342984273), in business since 2019 and founded by Bart Krawczyk (Co-founder, CTO) and Jake Slugocki (Co-founder, SEO, sales and marketing). Write to contact@cotlet.dev about the Sunsama tools.

## Sunsama MCP server: questions

### How do I connect Sunsama to ChatGPT or Claude?

Sign up at cotlet.dev, log in to Sunsama once in its Cloud Browser and add Cotlet to ChatGPT or Claude, following the steps in your console. No API key is needed. ChatGPT and Claude then work in your Sunsama account through Cotlet, in their phone apps too.

### What can ChatGPT do in Sunsama?

With Cotlet, ChatGPT, Claude and other AI agents handle jobs like these in Sunsama: plan my day from the backlog; timebox today's tasks on the calendar; log actual time at the end of the day. You ask in plain words, and anything that reaches other people waits for your OK first.

### How do I get access?

Sign up free at https://cotlet.dev, open Sunsama under Integrations in the console and sign in to Sunsama in its Cloud Browser. The trial starts with your first app, no card asked.

### Do I need a certain Sunsama plan?

Sunsama sells one plan for individuals, Pro, with a 14-day free trial (checked 6 Nov 2026). Its pricing page lists MCP in that plan. Cotlet works in your own Sunsama account and does not use that MCP route, so the plan you have in Sunsama is the plan your agent works under.

### Can my agent log actual time in Sunsama?

Yes, with set_actual_time. In June 2026 Sunsama said actual time in its official MCP was still on the backlog. Cotlet writes the actual time the way you would, on the task in Sunsama.

### Does Sunsama have a public API?

Not a documented one (checked 6 Nov 2026). The request on Sunsama's roadmap has been open since December 2019. Sunsama's own MCP server is the official route for agents. Cotlet adds REST over the same hosted tools, so n8n, Make and scripts can call them.

### Can I use the official Sunsama MCP and Cotlet together?

Yes. Keep the official server where it fits, and add Cotlet to the agents that need documented tools, REST or actual time.

### Is the MCP server different from the REST API?

Only in how you call it. Both have the same 14 tools, inputs and answers, one API key and one price. Agents use MCP; scripts and HTTP steps use REST.

### Is Cotlet affiliated with Sunsama?

No. Cotlet is independent and not affiliated with Summay, Inc., the company behind Sunsama.

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.