Smartsheet MCP Server

Smartsheet MCP Server

site icon
2025.04.04 0
TypeScript表格管理API集成交流协作
mcp-smartsheet 是一个用于与 Smartsheet API 集成的 Model Context Protocol (MCP) 服务器。它通过标准化接口允许 AI 助手与 Smartsheet 数据进行交互。该服务器提供了查看、读取、添加、更新 Smartsheet 电子表格数据的功能,并支持跨表格搜索。
View on GitHub

Overview

基本能力

产品定位

mcp-smartsheet 是一个用于与 Smartsheet API 集成的 MCP 服务器,旨在为 AI 助手提供与 Smartsheet 电子表格交互的标准接口。

核心功能

  • 列出可用表格:查看所有可访问的 Smartsheet 电子表格
  • 读取表格数据:访问特定表格的内容
  • 添加行:向电子表格添加新行
  • 更新行:更新现有行数据
  • 列出列:获取表格的列信息
  • 搜索:在所有表格中搜索特定文本

适用场景

  • AI 助手需要与 Smartsheet 数据进行交互
  • 需要自动化处理 Smartsheet 电子表格数据
  • 需要跨多个 Smartsheet 表格进行搜索

工具列表

  • listSheets:获取所有可用表格的列表
  • getSheet:获取包括行和单元格在内的完整表格内容
  • addRow:向表格添加新行
  • updateRow:更新表格中的现有行
  • listColumns:获取表格的列定义
  • searchSheets:在表格中搜索特定文本

常见问题解答

  • 如何获取 Smartsheet API 令牌?
  • 登录 Smartsheet 账户
  • 转到 Account > Personal Settings > API Access
  • 点击 "Generate new access token"
  • 复制令牌(之后将无法再次查看)

使用教程

使用依赖

  • Node.js (v16 或更高版本)
  • npm 或 yarn
  • Smartsheet API 令牌(从 Smartsheet UI 生成)

安装教程

  1. 克隆仓库: bash git clone https://github.com/yourusername/smartsheet-mcp-server.git cd smartsheet-mcp-server

  2. 安装依赖: bash npm install

  3. 构建项目: bash npm run build

调试方式

运行服务器:

SMARTSHEET_API_TOKEN=your_api_token npm start

MCP 配置示例(example-mcp-config.json):

{
  "mcpServers": {
    "smartsheet": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "SMARTSHEET_API_TOKEN": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude 配置示例(example-claude-config.json):

{
  "mcpServers": {
    "smartsheet": {
      "command": "node",
      "args": ["/path/to/mcp-smartsheet/dist/index.js"],
      "env": {
        "SMARTSHEET_API_TOKEN": "YOUR_SMARTSHEET_API_TOKEN"
      }
    }
  }
}

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。