{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-ai-mcp/smartsheet/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Manually configure the 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":"manually-configure-the-mcp-server","__idx":0},"children":["Manually configure the MCP server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your AI assistant uses a command-line interface (CLI) or integrates with an integrated development environment (IDE), it's likely that you will have to configure Smartsheet MCP Server access using a configuration file or command-line parameters. Exact paths and formats (for example, JSON, TOML, and others) vary by AI assistant. And some assistants support using environment values."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"environment-variables","__idx":1},"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 assistant supports Smartsheet's OAuth, such as ChatGPT (web or mobile), Claude AI, Claude Desktop, Gemini Enterprise Plus, or Microsoft 365 Copilot."]}]},{"$$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 assistants"]}]},{"$$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":2,"id":"example-configuration","__idx":2},"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":"MarkdownLink","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":"MarkdownLink","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":2,"id":"testing-your-server-connection","__idx":3},"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":"Heading","attributes":{"level":2,"id":"whats-next","__idx":4},"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":"MarkdownLink","attributes":{"href":"/ai-mcp/smartsheet/mcp-server-tools"},"children":["Smartsheet MCP server tools"]},"."]}]}]}]},"headings":[{"value":"Manually configure the MCP server","id":"manually-configure-the-mcp-server","depth":1},{"value":"Environment variables","id":"environment-variables","depth":2},{"value":"Example configuration","id":"example-configuration","depth":2},{"value":"Testing your server connection","id":"testing-your-server-connection","depth":2},{"value":"What's next?","id":"whats-next","depth":2}],"frontmatter":{"seo":{"title":"Manually configure the MCP server"}},"lastModified":"2026-08-31T18:46:55.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ai-mcp/smartsheet/install-the-smartsheet-mcp-server/manually-configure-the-mcp-server","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}