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

  1. Log in to ChatGPT in your browser.
  2. From the left side panel, select Apps.
  3. Click the settings cog icon in the top right corner.
  4. Under Advanced Settings, click Create App.
  5. Enter the following information:
    • Name: Sunsama
    • MCP Server URL: https://api.sunsama.com/mcp
    • Authentication: OAuth
  6. Agree to the terms and conditions and click Create.

Claude (Pro/Team)

  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

  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"]
        }
    }
}
  1. Close and restart Claude Desktop.
  2. 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"
        }
    }
}
  1. Save the file and return to the MCP settings page. You should see the server listed with a green status indicator.
  2. 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 streamable-http Sunsama https://api.sunsama.com/mcp
  1. Verify the server was added:
claude mcp list

You should see Sunsama in the list of configured servers.

  1. 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

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"]
        }
    }
}