Smartsheet MCP Server
Connect AI agents to Smartsheet sheets, rows, reports, and dashboards over MCP via OAuth.
Updated
What is Smartsheet MCP?
The Smartsheet MCP server is a Model Context Protocol server that lets AI agents and assistants work with your Smartsheet work-management data — sheets, projects, tasks, rows, reports, and dashboards — through a standard tool interface.
It is an official, vendor-hosted remote server operated by Smartsheet at https://mcp.smartsheet.com. Requests route through the Smartsheet REST API and return structured data with rich metadata (column types, row relationships, cell history, and comments), always respecting the authenticated user's existing permissions. It reached general availability in 2025 and works with any MCP-compliant client, including Claude, ChatGPT, Gemini, and custom agent frameworks.
Authentication uses OAuth 2.0 with configurable token scopes; clients that support Smartsheet OAuth can connect without provisioning a token manually, while personal access tokens (passed as a Bearer Authorization header) are available for custom integrations. Because it is hosted by Smartsheet, there is no server to deploy or maintain.
Tools the Smartsheet MCP server exposes
| Tool | What it does |
|---|---|
| search | Find resources by name or content across Smartsheet assets. |
| list_workspaces | Retrieve all accessible workspaces with pagination. |
| browse_workspace | Explore the top-level contents of a workspace. |
| get_sheet_summary | Retrieve sheet data with optional filtering, sorting, and column selection. |
| create_sheet | Create a new sheet within a specified folder or workspace. |
| add_rows | Add one or more new rows to a specified sheet. |
| update_rows | Modify existing row data in a sheet. |
| add_columns | Add one or more new columns to a specified sheet. |
| get_cell_history | Retrieve the modification history for specific cells. |
| list_reports | Retrieve a list of accessible reports. |
| list_dashboards | Retrieve a list of accessible dashboards. |
| add_comment | Add a reply to an existing discussion thread. |
Connect the Smartsheet MCP server
Claude Code
- 1
Run the add command
From your project, run: claude mcp add --transport http smartsheet-mcp https://mcp.smartsheet.com -H "Authorization:Bearer ${SMARTSHEET_API_TOKEN}"
- 2
Provide credentials
Set SMARTSHEET_API_TOKEN to a Smartsheet personal access token, or use a client that supports Smartsheet OAuth to authorize without a manual token.
- 3
Verify
Run /mcp in Claude Code to confirm the smartsheet-mcp server is connected, then ask it to list your workspaces.
Use your region's endpoint if you are outside the US.
Cursor
- 1
Open MCP settings
In Cursor, go to Settings > MCP (Tools & Integrations) and add a new MCP server.
- 2
Add the remote server
Configure an HTTP/streamable server with URL https://mcp.smartsheet.com and an Authorization: Bearer <token> header, or complete the OAuth prompt if offered.
- 3
Verify
Reload Cursor and confirm the Smartsheet tools appear, then prompt the agent to read a sheet.
Sample use cases
A scheduled agent reviews a project sheet each morning and flags overdue or at-risk tasks.
Stakeholders get a daily status without manual sheet review.
An event-triggered workflow appends rows to a tracking sheet when an upstream system fires.
Smartsheet stays in sync with external data automatically.
An agent summarizes a report or dashboard on request.
Teams get plain-language status from structured Smartsheet data.
Security & permissions
Authentication uses OAuth 2.0 with configurable API token scopes; custom integrations can alternatively use a personal access token sent as a Bearer Authorization header. The agent acts as the authenticated Smartsheet user and is bound by that user's existing sharing and permission model — it cannot see or change data the user couldn't access directly. Grant only the scopes your workflow needs, and prefer OAuth over long-lived personal tokens where the client supports it.
Using Smartsheet MCP with Gamut
In Gamut, the Smartsheet MCP server is attached as a tool that an agent can call inside an automated, event- or schedule-triggered workflow — for example, a nightly run that reads a project sheet, flags overdue rows, and posts an update, or a trigger that adds a row when an upstream event fires. Gamut manages the OAuth connection and credentials, so the agent invokes Smartsheet actions with the connected user's permissions without you handling tokens in the workflow itself.
Frequently asked questions
What is the Smartsheet MCP server?
It is an official Model Context Protocol server hosted by Smartsheet at https://mcp.smartsheet.com that exposes Smartsheet work-management data — sheets, rows, columns, reports, and dashboards — as tools any MCP-compliant AI agent can call.
Is the Smartsheet MCP server free?
The MCP server itself does not add a separate fee, but it requires a Smartsheet account, and what an agent can read or change follows your existing Smartsheet plan and the authenticated user's permissions. See Smartsheet's pricing page for plan details.
Is it hosted or self-hosted?
It is officially hosted by Smartsheet as a remote server at https://mcp.smartsheet.com with regional endpoints, so there is nothing to deploy or maintain yourself.
How do I connect Smartsheet MCP to Claude Code or Cursor?
In Claude Code, run claude mcp add --transport http smartsheet-mcp https://mcp.smartsheet.com with an Authorization Bearer header. In Cursor, add an HTTP MCP server pointing at the same URL. Both authenticate via OAuth 2.0 or a personal access token.