# 安装 Google Sheets MCP

- 类型: MCP 工具
- 说明: MCP server for the Google Sheets API: read and write ranges, sheets, formatting, charts, sharing.
- 仓库: https://github.com/A1-x-Tech/mcp-google-sheets

## 方式一 · 一键代装（复制提示词让 AI 代劳）

### Claude Code
```
请帮我安装 askskill 上的 "Google Sheets MCP" MCP 服务：
执行：claude mcp add 'io-github-a1-x-tech-mcp-google-sheets' -- npx -y @a1-x-tech/mcp-google-sheets
```

### Codex
```
请帮我安装 askskill 上的 "Google Sheets MCP" MCP 服务：
在 ~/.codex/config.toml 中添加：
[mcp_servers.io-github-a1-x-tech-mcp-google-sheets]
command = "npx"
args = ["-y","@a1-x-tech/mcp-google-sheets"]
然后重启 Codex 生效
```

### Cursor
```
请帮我安装 askskill 上的 "Google Sheets MCP" MCP 服务：
在 .cursor/mcp.json 的 "mcpServers" 中添加：
"io-github-a1-x-tech-mcp-google-sheets": { "command": "npx", "args": ["-y","@a1-x-tech/mcp-google-sheets"] }
然后在 Cursor 设置 > MCP 中启用
```

## 方式二 · 命令行安装（原生命令与配置）

### Claude Code
```bash
claude mcp add --env GOOGLE_SHEETS_CLIENT_ID=YOUR_VALUE --env GOOGLE_SHEETS_CLIENT_SECRET=YOUR_VALUE --env GOOGLE_SHEETS_REFRESH_TOKEN=YOUR_VALUE --env GOOGLE_SHEETS_ACCESS_TOKEN=YOUR_VALUE --env GOOGLE_SHEETS_OAUTH_PORT=YOUR_VALUE --env GOOGLE_SHEETS_API_BASE=YOUR_VALUE --env GOOGLE_SHEETS_TIMEOUT_MS=YOUR_VALUE --env GOOGLE_SHEETS_MAX_RETRIES=YOUR_VALUE --transport stdio io-github-a1-x-tech-mcp-google-sheets -- npx -y @a1-x-tech/mcp-google-sheets
```
需要环境变量：GOOGLE_SHEETS_CLIENT_ID, GOOGLE_SHEETS_CLIENT_SECRET, GOOGLE_SHEETS_REFRESH_TOKEN, GOOGLE_SHEETS_ACCESS_TOKEN, GOOGLE_SHEETS_OAUTH_PORT, GOOGLE_SHEETS_API_BASE, GOOGLE_SHEETS_TIMEOUT_MS, GOOGLE_SHEETS_MAX_RETRIES

### Codex
```bash
codex mcp add --env GOOGLE_SHEETS_CLIENT_ID=YOUR_VALUE --env GOOGLE_SHEETS_CLIENT_SECRET=YOUR_VALUE --env GOOGLE_SHEETS_REFRESH_TOKEN=YOUR_VALUE --env GOOGLE_SHEETS_ACCESS_TOKEN=YOUR_VALUE --env GOOGLE_SHEETS_OAUTH_PORT=YOUR_VALUE --env GOOGLE_SHEETS_API_BASE=YOUR_VALUE --env GOOGLE_SHEETS_TIMEOUT_MS=YOUR_VALUE --env GOOGLE_SHEETS_MAX_RETRIES=YOUR_VALUE io-github-a1-x-tech-mcp-google-sheets -- npx -y @a1-x-tech/mcp-google-sheets
```
配置文件 ~/.codex/config.toml：
```toml
[mcp_servers.io-github-a1-x-tech-mcp-google-sheets]
command = "npx"
args = ["-y","@a1-x-tech/mcp-google-sheets"]

[mcp_servers.io-github-a1-x-tech-mcp-google-sheets.env]
GOOGLE_SHEETS_CLIENT_ID = "YOUR_VALUE"
GOOGLE_SHEETS_CLIENT_SECRET = "YOUR_VALUE"
GOOGLE_SHEETS_REFRESH_TOKEN = "YOUR_VALUE"
GOOGLE_SHEETS_ACCESS_TOKEN = "YOUR_VALUE"
GOOGLE_SHEETS_OAUTH_PORT = "YOUR_VALUE"
GOOGLE_SHEETS_API_BASE = "YOUR_VALUE"
GOOGLE_SHEETS_TIMEOUT_MS = "YOUR_VALUE"
GOOGLE_SHEETS_MAX_RETRIES = "YOUR_VALUE"
```
需要环境变量：GOOGLE_SHEETS_CLIENT_ID, GOOGLE_SHEETS_CLIENT_SECRET, GOOGLE_SHEETS_REFRESH_TOKEN, GOOGLE_SHEETS_ACCESS_TOKEN, GOOGLE_SHEETS_OAUTH_PORT, GOOGLE_SHEETS_API_BASE, GOOGLE_SHEETS_TIMEOUT_MS, GOOGLE_SHEETS_MAX_RETRIES

### Cursor
配置文件 .cursor/mcp.json：
```json
{
  "mcpServers": {
    "io-github-a1-x-tech-mcp-google-sheets": {
      "command": "npx",
      "args": [
        "-y",
        "@a1-x-tech/mcp-google-sheets"
      ],
      "env": {
        "GOOGLE_SHEETS_CLIENT_ID": "YOUR_VALUE",
        "GOOGLE_SHEETS_CLIENT_SECRET": "YOUR_VALUE",
        "GOOGLE_SHEETS_REFRESH_TOKEN": "YOUR_VALUE",
        "GOOGLE_SHEETS_ACCESS_TOKEN": "YOUR_VALUE",
        "GOOGLE_SHEETS_OAUTH_PORT": "YOUR_VALUE",
        "GOOGLE_SHEETS_API_BASE": "YOUR_VALUE",
        "GOOGLE_SHEETS_TIMEOUT_MS": "YOUR_VALUE",
        "GOOGLE_SHEETS_MAX_RETRIES": "YOUR_VALUE"
      }
    }
  }
}
```
一键安装：cursor://anysphere.cursor-deeplink/mcp/install?name=io-github-a1-x-tech-mcp-google-sheets&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhMS14LXRlY2gvbWNwLWdvb2dsZS1zaGVldHMiXSwiZW52Ijp7IkdPT0dMRV9TSEVFVFNfQ0xJRU5UX0lEIjoiWU9VUl9WQUxVRSIsIkdPT0dMRV9TSEVFVFNfQ0xJRU5UX1NFQ1JFVCI6IllPVVJfVkFMVUUiLCJHT09HTEVfU0hFRVRTX1JFRlJFU0hfVE9LRU4iOiJZT1VSX1ZBTFVFIiwiR09PR0xFX1NIRUVUU19BQ0NFU1NfVE9LRU4iOiJZT1VSX1ZBTFVFIiwiR09PR0xFX1NIRUVUU19PQVVUSF9QT1JUIjoiWU9VUl9WQUxVRSIsIkdPT0dMRV9TSEVFVFNfQVBJX0JBU0UiOiJZT1VSX1ZBTFVFIiwiR09PR0xFX1NIRUVUU19USU1FT1VUX01TIjoiWU9VUl9WQUxVRSIsIkdPT0dMRV9TSEVFVFNfTUFYX1JFVFJJRVMiOiJZT1VSX1ZBTFVFIn19
需要环境变量：GOOGLE_SHEETS_CLIENT_ID, GOOGLE_SHEETS_CLIENT_SECRET, GOOGLE_SHEETS_REFRESH_TOKEN, GOOGLE_SHEETS_ACCESS_TOKEN, GOOGLE_SHEETS_OAUTH_PORT, GOOGLE_SHEETS_API_BASE, GOOGLE_SHEETS_TIMEOUT_MS, GOOGLE_SHEETS_MAX_RETRIES