{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-ai-mcp/smartsheet/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Connect Gemini CLI to 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":"connect-gemini-cli-to-the-smartsheet-mcp-server","__idx":0},"children":["Connect Gemini CLI to the Smartsheet MCP server"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With Gemini CLI 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":"Heading","attributes":{"level":2,"id":"connection-steps","__idx":1},"children":["Connection steps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With Gemini CLI, you can configure an MCP server connection for a local project or your user."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For options on configuring MCP server connections (including connection scope), please refer to the Gemini CLI documentation."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"gemini-cli-project-specific-setup","__idx":2},"children":["Gemini CLI project-specific setup"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is the simplest way to connect for a session."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Execute the following command, with your values:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"gemini mcp add \\\n  -t http \\\n  -H \"Authorization:Bearer ${SMARTSHEET_API_TOKEN}\" \\\n  smartsheet-mcp https://mcp.smartsheet.com\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replace:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${SMARTSHEET_API_TOKEN}"]}," with the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ai-mcp/smartsheet/install-the-smartsheet-mcp-server#environment-variables"},"children":["environment variable"]}," for your Smartsheet API token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smartsheet-mcp"]}," with a name you're using for the connection."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The URL with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ai-mcp/smartsheet/install-the-smartsheet-mcp-server#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":"p","attributes":{},"children":["Verify your server connection:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"gemini mcp list \n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Smartsheet MCP server appears in the list, and its status is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Connected"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Running"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Test the MCP server connection with a 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":["You've connected Gemini CLI to the Smartsheet MCP server for your project."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The connection persists within the folder where you've invoked it. The hidden folder ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["./gemini/"]}," contains your configuration."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"gemini-cli-global-user-configuration","__idx":3},"children":["Gemini CLI global user configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here's how to configure the MCP server for use anywhere on your machine."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Edit ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["~/.gemini/settings.json"]}," and add an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcpServers"]}," section like the one below:"]},{"$$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":["Replace:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["smartsheet-mcp"]}," with a name you're using for the connection."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["${SMARTSHEET_API_TOKEN}"]}," with the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ai-mcp/smartsheet/install-the-smartsheet-mcp-server#environment-variables"},"children":["environment variable"]}," for your Smartsheet API token."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["httpUrl"]}," value with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ai-mcp/smartsheet/install-the-smartsheet-mcp-server#prerequisites"},"children":["your region's URL"]}]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Verify your server connection:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"gemini mcp list \n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Smartsheet MCP server appears in the list, and its status is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Connected"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Running"]},"."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Test the MCP server connection with a 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":["You've connected Gemini CLI to the Smartsheet MCP server for your user."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"whats-next","__idx":4},"children":["What's next?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Now that you've connected to the Smartsheet MCP server, you can interact with your Smartsheet data in a conversational way."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Check out the example prompts 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":"p","attributes":{},"children":["Want to learn more about the MCP server's capabilities? Visit ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/ai-mcp/smartsheet/mcp-server-tools"},"children":["Smartsheet MCP server tools"]},"."]}]},"headings":[{"value":"Connect Gemini CLI to the Smartsheet MCP server","id":"connect-gemini-cli-to-the-smartsheet-mcp-server","depth":1},{"value":"Connection steps","id":"connection-steps","depth":2},{"value":"Gemini CLI project-specific setup","id":"gemini-cli-project-specific-setup","depth":3},{"value":"Gemini CLI global user configuration","id":"gemini-cli-global-user-configuration","depth":3},{"value":"What's next?","id":"whats-next","depth":2}],"frontmatter":{"seo":{"title":"Connect Gemini CLI to the Smartsheet MCP server"}},"lastModified":"2026-05-19T19:54:33.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ai-mcp/smartsheet/install-the-smartsheet-mcp-server/connect-gemini-cli","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}