Install SmartSuite MCP Server

Connect Claude Desktop to your SmartSuite workspace

Choose Installation Mode

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

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