Install SmartSuite MCP Server

Connect as a Custom Connector No install

Claude Desktop, Claude.ai, mobile and Cowork can connect directly with OAuth. No proxy, no config files, no app-issued API key: you sign in with your own SmartSuite API key.

1

Add the connector

In Claude open Customize → Connectors → Yours. If your organization already added the connector, click Connect on it and go to step 2. Otherwise choose Add → Add custom connector and paste this URL:

https://smartsuite-mcp.afal.mx/mcp

Leave the OAuth client ID and secret empty unless your administrator gave you one.

2

Sign in with SmartSuite

Click Connect. A page from this server asks for the email of your SmartSuite account, your personal API key and, unless this server is dedicated to one workspace, your SmartSuite Workspace ID (the short id in your SmartSuite URL).

To find the key: in SmartSuite click your profile picture → My Profile and scroll to the API Key section. Click the TOKEN field to reveal the key, then copy it. Do not use the destroy-token link next to it.

3

Start using SmartSuite

Try: "List my SmartSuite solutions". Each person connects with their own key, so access matches their SmartSuite permissions.

Organization admins: add the same URL under Organization settings → Connectors → Add → Custom → Web to make it available to everyone in your Claude organization. A stable OAuth client can be created on the server with bin/rails oauth:create_client.

Alternative: header-based clients

For Claude Code, scripts, or clients that send a fixed Authorization: Bearer header, use an app-issued API key with the installers below.

Connect to a hosted MCP server. Best for teams and quick setup.

Your API Key

1

Run the installer

curl -fsSL 'https://smartsuite-mcp.afal.mx/install.sh' | bash -s -- remote 'https://smartsuite-mcp.afal.mx/mcp' 'YOUR_API_KEY'

2

Restart Claude Desktop

The installer automatically configures Claude Desktop for you.

3

Start using SmartSuite

Try: "List my SmartSuite solutions"

Run the MCP server locally. Requires Ruby and your SmartSuite API credentials.

1

Run the installer

curl -fsSL 'https://smartsuite-mcp.afal.mx/install.sh' | bash -s -- local

2

Add your SmartSuite credentials

Edit the Claude Desktop config to add your SMARTSUITE_API_KEY and SMARTSUITE_ACCOUNT_ID.

3

Restart Claude Desktop

The server will start automatically when Claude Desktop launches.

Manual Configuration

If you prefer to configure Claude Desktop manually, add this to your config file:

Windows note: Uses cmd.exe wrapper to handle spaces in "Program Files" path.

{
  "mcpServers": {
    "smartsuite": {
      "command": "cmd.exe",
      "args": ["/c", "npx", "-y", "mcp-remote", "https://smartsuite-mcp.afal.mx/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]
    }
  }
}

{
  "mcpServers": {
    "smartsuite": {
      "command": "ruby",
      "args": ["~/.smartsuite-mcp/smartsuite_server.rb"],
      "env": {
        "SMARTSUITE_API_KEY": "YOUR_SMARTSUITE_API_KEY",
        "SMARTSUITE_ACCOUNT_ID": "YOUR_SMARTSUITE_ACCOUNT_ID"
      }
    }
  }
}

Config file location:
~/.config/Claude/claude_desktop_config.json