MCP (Model Context Protocol)

Connect AI assistants to your Sunsama data using the MCP open standard.

Connect an AI assistant like ChatGPT, Claude or Cursor to Sunsama, so you can ask it to plan your day, add tasks or check your calendar in plain language. Sunsama runs a remote MCP (Model Context Protocol) server: add its URL to your assistant and sign in with Sunsama when asked.

MCP Server URL

https://api.sunsama.com/mcp

Use this URL to connect from any MCP-compatible client. Sunsama supports the Streamable HTTP transport and signs you in with OAuth. You can also copy the URL from Settings > Integrations > MCP.

What you can do

Once connected, your assistant can work with:

• Tasks: create, search and edit tasks, subtasks, notes and comments; move them between days or to the backlog; complete, delete or restore them; set priorities, planned time, due dates and recurrence; make a task Focused or Parallel.
• Calendar: read your events, create, move or delete events, timebox tasks, import an event as a task, and accept or decline invites.
• Time tracking: start and stop timers, and read or edit tracked time.
• Planning: create and edit weekly objectives, read your daily highlights, set your shutdown time, and manage channels.
• Help: read Sunsama’s help center articles to answer questions about how Sunsama works.

Your assistant can’t read your email or the other tools you’ve connected to Sunsama, such as Jira or Gmail. Sunny, the assistant built into Sunsama, can.

ChatGPT

You can add Sunsama to ChatGPT straight from ChatGPT’s built-in plugin directory.

Install it for yourself

1. Open the plugin directory at chatgpt.com/plugins, or go straight to the Sunsama listing.
2. Open the Sunsama listing and click the + button to install it.
3. Click Connect and sign in to Sunsama to authorize access.
4. Start a new chat, then ask ChatGPT to work with your Sunsama tasks — or type @Sunsama to call it directly.

Install it for your whole workspace (admins)

If you’re a workspace Owner or Admin, you can roll Sunsama out to everyone instead of having each person install it individually:

1. Go to the admin plugin settings at chatgpt.com/admin/plugins.
2. Search for Sunsama and open its listing.
3. Install it for your workspace. You can make it available to all members, or scope it to specific groups or roles.
4. Sunsama then appears in each member’s Plugins directory. Everyone still clicks Connect once to sign in to their own Sunsama account.

Claude

Sunsama works as a custom connector on every Claude plan, including Free. Once you add it, it’s available everywhere you use Claude — on the web, in Claude Desktop, and in the mobile apps.

One-click setup

1. Open this link to add Sunsama to Claude.
2. Click Continue.

If you’re an Owner of a Claude Team or Enterprise organization, use this link to add Sunsama for your whole organization instead. Members then find Sunsama under Customize > Connectors and click Connect.

Manual setup

1. Go to Customize > Connectors > Add > Add Custom Connector.
2. Enter Sunsama as the app name.
3. Enter https://api.sunsama.com/mcp as the Remote MCP Server URL.
4. Click Add.
5. Click on the Sunsama connector, then click Connect.

Claude Desktop (local config)

Use this if you’re on Claude’s Free plan and already using your one custom connector. It only works in Claude Desktop, not on the web or mobile, and requires Node.js to be installed.

1. Open your claude_desktop_config.json file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Add the following to the file:

{
    "mcpServers": {
        "Sunsama": {
            "command": "npx",
            "args": ["mcp-remote@latest", "https://api.sunsama.com/mcp"]
        }
    }
}

3. Close and restart Claude Desktop.
4. Go through the authentication flow when prompted.

Cursor

1. Open Cursor and go to Settings (gear icon) > MCP.
2. Click + Add new global MCP server. This opens the ~/.cursor/mcp.json file.
3. Add the following configuration:

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

4. Save the file and return to the MCP settings page. You should see the server listed with a green status indicator.
5. Open Agent mode in Cursor’s chat panel (not “Ask” or “Edit” mode) to start using the MCP tools.

Claude Code

1. Open your terminal and run the following command to add the MCP server:

claude mcp add --transport http Sunsama https://api.sunsama.com/mcp

2. Verify the server was added:

claude mcp list

You should see Sunsama in the list of configured servers.

3. Start a Claude Code session. The Sunsama tools are available right away. Try asking “what’s on my plan today?”.

To remove the server later:

claude mcp remove Sunsama

Notion (paid)

1. Open your Custom Agent’s Settings.
2. Go to Tools & Access.
3. Click Add connection → Custom MCP server.
4. Enter the following:
   • MCP server URL: https://api.sunsama.com/mcp
   • Display name: Sunsama
5. Expand Advanced settings and set the Client ID to:

   7b39528e-3f01-47cd-a0fb-993c00201f58

6. Click Save and complete the OAuth sign-in when prompted.

Other Clients

Any MCP-compatible tool can connect to Sunsama’s MCP server. If your client supports remote MCP servers natively, point it to:

https://api.sunsama.com/mcp

If your client only supports stdio-based (local) MCP servers, use the mcp-remote package as a bridge:

{
    "mcpServers": {
        "Sunsama": {
            "command": "npx",
            "args": ["mcp-remote@latest", "https://api.sunsama.com/mcp"]
        }
    }
}

Managing connected apps

Go to Settings > Integrations > MCP to see the apps connected to your workspace, when each was last used, and whether it has offline access. Click Disconnect to remove an app’s access.

For clients that don’t support OAuth, open Bearer token to create a long-lived token and send it in the Authorization header. This option is kept for older clients and may be removed in a future release.

Troubleshooting

“MCP access is disabled by workspace policy”

An admin of your Enterprise workspace has turned off MCP server access under AI Feature Controls. Ask them to turn it back on.

Your assistant says you need to upgrade

If your Sunsama trial has ended, MCP clients can’t reach your data until you upgrade to a paid plan.

Related

• Sunny
• Privacy notes