MCP (Model Context Protocol)

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

Sunsama’s MCP (Model Context Protocol) server lets AI assistants connect directly to your Sunsama data. MCP is an open standard that gives AI tools structured access to external services — your assistant can interact with your tasks and workflows without manual copy-pasting.

The server is remotely hosted and uses OAuth for authentication. Connect from any supported client using the URL below.

MCP Server URL

https://api.sunsama.com/mcp

Use this URL to connect from any MCP-compatible client.

ChatGPT

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

Install it for yourself

Open the plugin directory at chatgpt.com/plugins, or go straight to the Sunsama listing.
Open the Sunsama listing and click the + button to install it.
Click Connect and sign in to Sunsama to authorize access.
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:

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

Claude (Pro/Team)

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

Claude Desktop

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

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

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

Cursor

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

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

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

Claude Code

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

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

Verify the server was added:

claude mcp list

You should see Sunsama in the list of configured servers.

Start a Claude Code session. The MCP tools are available immediately — ask Claude to search your API endpoints, read documentation, or execute requests.

To remove the server later:

claude mcp remove Sunsama

Notion (paid)

Open your Custom Agent’s Settings.
Go to Tools & Access.
Click Add connection → Custom MCP server.
Enter the following:
- MCP server URL: https://api.sunsama.com/mcp
- Display name: Sunsama
Expand Advanced settings and set the Client ID to:
```
7b39528e-3f01-47cd-a0fb-993c00201f58
```
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"]
        }
    }
}