Sunsama Agent Plugin

Packages Sunsama's official remote MCP so Cursor (and other Agent Plugins clients) can work with daily tasks and planning.

This is not iOS Mail, Apple Mail, or Gmail. Sunsama is a daily planner. This plugin does not read or send email.

Official MCP URL (OAuth, client-managed auth):

https://api.sunsama.com/mcp

Sunsama does not publish a public REST API. This plugin does not wrap GraphQL, does not invent tools, and does not store tokens.

What you get

Path	Role
`plugin.json`	Agent Plugins 1.0.0 manifest (`name`: `sunsama`, `version`: `0.1.0`)
`mcp.json`	`streamable-http` server pointing at the official URL. No headers.
`skills/sunsama/SKILL.md`	When to use the MCP; never invent `SunsamaTask` fields

Auth stays with the client. Agent Plugins 1.0.0 has no portable OAuth or credential fields. Do not put tokens in mcp.json headers or plugin variables.

Install in Cursor

This repo is an Agent Plugin (root plugin.json), not a Cursor Plugin (.cursor-plugin/). Cursor loads both formats.

Local (from this folder)

Symlink or copy the plugin into Cursor's local plugin directory:
```
ln -s /path/to/this/repo ~/.cursor/plugins/local/sunsama
```
Restart Cursor, or run Developer: Reload Window.
Open Customize and confirm the sunsama skill and MCP server are listed.
Complete Sunsama OAuth when the client prompts you. The MCP tools appear only after that.

On Teams and Enterprise, an admin must allow local plugin imports (Dashboard → Settings → Security & Identity → Marketplace and Plugins).

From a marketplace

Install from Customize like any other plugin, then complete OAuth. This package is not published to the Cursor Marketplace.

Official Sunsama MCP-only path (no plugin)

Sunsama also documents adding the same URL in Cursor MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "Sunsama": {
      "url": "https://api.sunsama.com/mcp"
    }
  }
}

Use that if you only want the remote server. This plugin adds the Agent Plugins manifest and the when-to-use skill.

OAuth

The server is remotely hosted and authenticates with OAuth.
Cursor/clients should start OAuth when the plugin's streamable-http server is loaded.
There is no API key to paste into this repo.
tools/call against a real Sunsama account cannot work until OAuth succeeds.

If the server stays red in MCP settings, refresh it and finish the sign-in prompt. See Sunsama MCP docs.

Not in scope

Gmail, iOS Mail, or any mail client
Unofficial wrappers (robertn702/sunsama-api, mcp-remote) — Agent Plugins already allows a remote url
Invented task titles, ids, or sample SunsamaTask data
Publishing this plugin

Validate locally

See PROVE.md for Linux schema validation and an unauthenticated endpoint probe.