{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-ai-mcp/smartsheet/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Install the Smartsheet MCP server","siteUrl":"https://developers.smartsheet.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"install-the-smartsheet-mcp-server","__idx":0},"children":["Install the Smartsheet MCP server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can connect various AI clients to the Smartsheet Model Context Protocol (MCP) server. Connected to the Smartsheet MCP server, you can interact with your Smartsheet data using natural language."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required plan:"]}," Business, Enterprise, or Advanced Work Management"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This article:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Defines connection prerequisites"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provides an overview of the installation steps"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Links to setup instructions for various AI clients"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start with considering what's required."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here's what a Smartsheet MCP server connection requires:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Network access to a Smartsheet production server environment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Valid Smartsheet API token, unless you're connecting an AI tool that supports Smartsheet's OAuth, such as Claude AI or Claude Desktop. To create an API token, refer to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/api/smartsheet/guides/getting-started#generate-an-api-access-token"},"children":["Get started"]}," article."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["URL for the MCP server production environment in your target region. Refer to the table below."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Region URLs"]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Region"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Environment"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["MCP server URL"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["United States"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["US production"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.smartsheet.com"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Europe"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["EU production"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.smartsheet.eu"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Australia"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["AU production"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://mcp.smartsheet.au"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Now that you know what's required, it's time to orient yourself with the the connection setup steps by way of the following overview."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"installation-overview","__idx":2},"children":["Installation overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["AI clients provide various ways to register connections with MCP servers. These may include:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["User interface in a web or desktop application"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Commands to execute in a terminal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A file to edit"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As such, check your AI client documentation for the MCP server registration options they provide."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you register an MCP server with a local client, the client typically stores the registration configuration in a file. Exact paths and formats (for example, JSON, TOML, and others) vary by client. And some clients support using environment values."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"environment-variables","__idx":3},"children":["Environment variables"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For confidential information, such as Smartsheet API tokens, consider using environment variables."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API tokens are unnecessary if your AI tool supports Smartsheet's OAuth, such as Claude AI or Claude Desktop."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Benefits:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["No secrets in configuration files that might get shared or committed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["One place to update when rotating tokens"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Same configuration file works for everyone on a team (each person sets their own environment variable)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Same environment variable referenced for all MCP server configs for all tools"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set an environment variable (the name is arbitrary)."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"export SMARTSHEET_API_TOKEN=\"value\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you configure your connection via a terminal command or a configuration file, use your environment variable (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${SMARTSHEET_API_TOKEN}"]},") in place of your API token."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-configuration","__idx":4},"children":["Example configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here's an MCP server configuration from a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["settings.json"]}," file for Gemini CLI:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"smartsheet-mcp\": {\n      \"httpUrl\": \"https://mcp.smartsheet.com\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${SMARTSHEET_API_TOKEN}\"\n      }\n    }\n  }\n}\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the above example, you would replace:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smartsheet-mcp"]}," with an arbitrary name you want to use for your connection."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The URL with ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#prerequisites"},"children":["your region's URL"]},", if you're using a regional server outside the US."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${SMARTSHEET_API_TOKEN}"]}," with the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#environment-variables"},"children":["environment variable"]}," for your Smartsheet API token."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you want to connect to Smartsheet production servers in multiple regions simultaneously, add their configurations to your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcpServers"]}," object."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example,"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"javascript","header":{"controls":{"copy":{}}},"source":"{\n  \"mcpServers\": {\n    \"smartsheet-us\": {\n      \"httpUrl\": \"https://mcp.smartsheet.com\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${SMARTSHEET_API_TOKEN}\"\n      }\n    },\n    \"smartsheet-eu\": {\n      \"httpUrl\": \"https://mcp.smartsheet.eu\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${SMARTSHEET_API_TOKEN_EU}\"\n      }\n    },\n    \"smartsheet-au\": {\n      \"httpUrl\": \"https://mcp.smartsheet.au\",\n      \"headers\": {\n        \"Authorization\": \"Bearer ${SMARTSHEET_API_TOKEN_AU}\"\n      }\n    }\n  }\n}\n","lang":"javascript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The configuration above registers connections to production servers for the United States, European Union, and Australia regions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"testing-your-server-connection","__idx":5},"children":["Testing your server connection"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After registering the Smartsheet MCP server and connecting to it, test your server connection."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Test prompt:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"List the Smartsheet MCP server tools.\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response includes Smartsheet tools such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_sheet_summary"]}," and more."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Now that you understand Smartsheet MCP server installation, it's time to connect your AI client to the MCP server."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"connect-to-the-mcp-server","__idx":6},"children":["Connect to the MCP server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here are links to various AI client setup instructions."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AI Client"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":""},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Instructions"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Claude and Claude Desktop"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/ai-mcp/smartsheet/install-the-smartsheet-mcp-server/connect-claude"},"children":["Instructions"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Claude Code"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/ai-mcp/smartsheet/install-the-smartsheet-mcp-server/connect-claude-code"},"children":["Instructions"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Codex"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/ai-mcp/smartsheet/install-the-smartsheet-mcp-server/connect-codex"},"children":["Instructions"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Cursor"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/ai-mcp/smartsheet/install-the-smartsheet-mcp-server/connect-cursor"},"children":["Instructions"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Gemini CLI"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/ai-mcp/smartsheet/install-the-smartsheet-mcp-server/connect-gemini-cli"},"children":["Instructions"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"custom-ai-client-connections","__idx":7},"children":["Custom AI client connections"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you want to connect a custom, MCP-compliant client to the Smartsheet MCP server, follow the general guidance above in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#installation-overview"},"children":["Installation overview"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you're using a configuration file in your client, the configuration may be similar to the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"#example-configuration"},"children":["Example configuration"]}," above."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"whats-next","__idx":8},"children":["What's next?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once you're connected to the MCP server, you can:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check out the example prompts described in ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://help.smartsheet.com/articles/2483716-smartsheet-mcp-prompt-cookbook","target":"_blank","rel":"noopener noreferrer"},"children":["Smartsheet MCP prompt cookbook"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn more about the MCP server's capabilities at ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/ai-mcp/smartsheet/mcp-server-tools"},"children":["Smartsheet MCP server tools"]},"."]}]}]}]},"headings":[{"value":"Install the Smartsheet MCP server","id":"install-the-smartsheet-mcp-server","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"Installation overview","id":"installation-overview","depth":2},{"value":"Environment variables","id":"environment-variables","depth":3},{"value":"Example configuration","id":"example-configuration","depth":3},{"value":"Testing your server connection","id":"testing-your-server-connection","depth":3},{"value":"Connect to the MCP server","id":"connect-to-the-mcp-server","depth":2},{"value":"Custom AI client connections","id":"custom-ai-client-connections","depth":2},{"value":"What's next?","id":"whats-next","depth":2}],"frontmatter":{"seo":{"title":"Install the Smartsheet MCP server"}},"lastModified":"2026-05-22T16:55:52.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ai-mcp/smartsheet/install-the-smartsheet-mcp-server","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}