feat(tools): added microsoft excel tools/block (#441)

* got the read excel tool working * added read manual ID insertion * write working * tool finished * removed old logic * removed logic that was causing credential error * cleaned up * ran bun lint * removed logger * added back merging logic * fix: removed comments * fix: added greptile changes * ran bun lint * removed function * added microsoft excel docs * fix: icon format * fix: docs * ran lint --------- Co-authored-by: Adam Gough <adamgough@Adams-MacBook-Pro.local>
2026-01-10 07:27:57 -05:00 · 2025-05-30 19:11:45 -07:00
parent e17cdc9698
commit c5727ef018
20 changed files with 1911 additions and 6 deletions
--- a/apps/docs/content/docs/tools/linear.mdx
+++ b/apps/docs/content/docs/tools/linear.mdx
@@ -9,7 +9,19 @@ import { BlockInfoCard } from "@/components/ui/block-info-card"
  type="linear"
  color="#5E6AD2"
  icon={true}
-  iconSvg={`<svg className="block-icon"  xmlns="http://www.w3.org/2000/svg" fill="none"   viewBox="0 0 100 100"><path fill="#fff" d="M1.22541 61.5228c-.2225-.9485.90748-1.5459 1.59638-.857L39.3342 97.1782c.6889.6889.0915 1.8189-.857 1.5964C20.0515 94.4522 5.54779 79.9485 1.22541 61.5228ZM.00189135 46.8891c-.01764375.2833.08887215.5599.28957165.7606L52.3503 99.7085c.2007.2007.4773.3075.7606.2896 2.3692-.1476 4.6938-.46 6.9624-.9259.7645-.157 1.0301-1.0963.4782-1.6481L2.57595 39.4485c-.55186-.5519-1.49117-.2863-1.648174.4782-.465915 2.2686-.77832 4.5932-.92588465 6.9624ZM4.21093 29.7054c-.16649.3738-.08169.8106.20765 1.1l64.77602 64.776c.2894.2894.7262.3742 1.1.2077 1.7861-.7956 3.5171-1.6927 5.1855-2.684.5521-.328.6373-1.0867.1832-1.5407L8.43566 24.3367c-.45409-.4541-1.21271-.3689-1.54074.1832-.99132 1.6684-1.88843 3.3994-2.68399 5.1855ZM12.6587 18.074c-.3701-.3701-.393-.9637-.0443-1.3541C21.7795 6.45931 35.1114 0 49.9519 0 77.5927 0 100 22.4073 100 50.0481c0 14.8405-6.4593 28.1724-16.7199 37.3375-.3903.3487-.984.3258-1.3542-.0443L12.6587 18.074Z"/></svg>`}
+  iconSvg={`<svg className="block-icon"
+      
+      xmlns='http://www.w3.org/2000/svg'
+      fill='currentColor'
+      
+      
+      viewBox='0 0 100 100'
+    >
+      <path
+        fill='currentColor'
+        d='M1.22541 61.5228c-.2225-.9485.90748-1.5459 1.59638-.857L39.3342 97.1782c.6889.6889.0915 1.8189-.857 1.5964C20.0515 94.4522 5.54779 79.9485 1.22541 61.5228ZM.00189135 46.8891c-.01764375.2833.08887215.5599.28957165.7606L52.3503 99.7085c.2007.2007.4773.3075.7606.2896 2.3692-.1476 4.6938-.46 6.9624-.9259.7645-.157 1.0301-1.0963.4782-1.6481L2.57595 39.4485c-.55186-.5519-1.49117-.2863-1.648174.4782-.465915 2.2686-.77832 4.5932-.92588465 6.9624ZM4.21093 29.7054c-.16649.3738-.08169.8106.20765 1.1l64.77602 64.776c.2894.2894.7262.3742 1.1.2077 1.7861-.7956 3.5171-1.6927 5.1855-2.684.5521-.328.6373-1.0867.1832-1.5407L8.43566 24.3367c-.45409-.4541-1.21271-.3689-1.54074.1832-.99132 1.6684-1.88843 3.3994-2.68399 5.1855ZM12.6587 18.074c-.3701-.3701-.393-.9637-.0443-1.3541C21.7795 6.45931 35.1114 0 49.9519 0 77.5927 0 100 22.4073 100 50.0481c0 14.8405-6.4593 28.1724-16.7199 37.3375-.3903.3487-.984.3258-1.3542-.0443L12.6587 18.074Z'
+      />
+    </svg>`}
 />

 {/* MANUAL-CONTENT-START:intro */}
--- a/apps/docs/content/docs/tools/meta.json
+++ b/apps/docs/content/docs/tools/meta.json
@@ -25,6 +25,7 @@
    "linkup",
    "mem0",
    "memory",
+    "microsoft_excel",
    "microsoft_teams",
    "mistral_parse",
    "notion",
--- a/apps/docs/content/docs/tools/microsoft_excel.mdx
+++ b/apps/docs/content/docs/tools/microsoft_excel.mdx
@@ -0,0 +1,197 @@
+---
+title: Microsoft Excel
+description: Read, write, and update data
+---
+
+import { BlockInfoCard } from "@/components/ui/block-info-card"
+
+<BlockInfoCard 
+  type="microsoft_excel"
+  color="#E0E0E0"
+  icon={true}
+  iconSvg={`<svg className="block-icon"
+      
+      xmlns='http://www.w3.org/2000/svg'
+      version='1.1'
+      id='Livello_1'
+      x='0px'
+      y='0px'
+      viewBox='0 0 2289.75 2130'
+      enableBackground='new 0 0 2289.75 2130'
+    >
+      <path
+        fill='#185C37'
+        d='M1437.75,1011.75L532.5,852v1180.393c0,53.907,43.7,97.607,97.607,97.607l0,0h1562.036  c53.907,0,97.607-43.7,97.607-97.607l0,0V1597.5L1437.75,1011.75z'
+      />
+      <path
+        fill='#21A366'
+        d='M1437.75,0H630.107C576.2,0,532.5,43.7,532.5,97.607c0,0,0,0,0,0V532.5l905.25,532.5L1917,1224.75  L2289.75,1065V532.5L1437.75,0z'
+      />
+      <path fill='#107C41' d='M532.5,532.5h905.25V1065H532.5V532.5z' />
+      <path
+        opacity='0.1'
+        enableBackground='new'
+        d='M1180.393,426H532.5v1331.25h647.893c53.834-0.175,97.432-43.773,97.607-97.607  V523.607C1277.825,469.773,1234.227,426.175,1180.393,426z'
+      />
+      <path
+        opacity='0.2'
+        enableBackground='new'
+        d='M1127.143,479.25H532.5V1810.5h594.643  c53.834-0.175,97.432-43.773,97.607-97.607V576.857C1224.575,523.023,1180.977,479.425,1127.143,479.25z'
+      />
+      <path
+        opacity='0.2'
+        enableBackground='new'
+        d='M1127.143,479.25H532.5V1704h594.643c53.834-0.175,97.432-43.773,97.607-97.607  V576.857C1224.575,523.023,1180.977,479.425,1127.143,479.25z'
+      />
+      <path
+        opacity='0.2'
+        enableBackground='new'
+        d='M1073.893,479.25H532.5V1704h541.393c53.834-0.175,97.432-43.773,97.607-97.607  V576.857C1171.325,523.023,1127.727,479.425,1073.893,479.25z'
+      />
+      <linearGradient
+        id='SVGID_1_'
+        gradientUnits='userSpaceOnUse'
+        x1='203.5132'
+        y1='1729.0183'
+        x2='967.9868'
+        y2='404.9817'
+        gradientTransform='matrix(1 0 0 -1 0 2132)'
+      >
+        <stop offset='0' style={{ stopColor: '#18884F' }} />
+        <stop offset='0.5' style={{ stopColor: '#117E43' }} />
+        <stop offset='1' style={{ stopColor: '#0B6631' }} />
+      </linearGradient>
+      <path
+        fill='url(#SVGID_1_)'
+        d='M97.607,479.25h976.285c53.907,0,97.607,43.7,97.607,97.607v976.285  c0,53.907-43.7,97.607-97.607,97.607H97.607C43.7,1650.75,0,1607.05,0,1553.143V576.857C0,522.95,43.7,479.25,97.607,479.25z'
+      />
+      <path
+        fill='#FFFFFF'
+        d='M302.3,1382.264l205.332-318.169L319.5,747.683h151.336l102.666,202.35  c9.479,19.223,15.975,33.494,19.49,42.919h1.331c6.745-15.336,13.845-30.228,21.3-44.677L725.371,747.79h138.929l-192.925,314.548  L869.2,1382.263H721.378L602.79,1160.158c-5.586-9.45-10.326-19.376-14.164-29.66h-1.757c-3.474,10.075-8.083,19.722-13.739,28.755  l-122.102,223.011H302.3z'
+      />
+      <path
+        fill='#33C481'
+        d='M2192.143,0H1437.75v532.5h852V97.607C2289.75,43.7,2246.05,0,2192.143,0L2192.143,0z'
+      />
+      <path fill='#107C41' d='M1437.75,1065h852v532.5h-852V1065z' />
+    </svg>`}
+/>
+
+{/* MANUAL-CONTENT-START:intro */}
+[Microsoft Teams](https://www.microsoft.com/en-us/microsoft-365/excel) is a powerful spreadsheet application that enables data management, analysis, and visualization. Through the Microsoft Excel integration in Sim Studio, you can programmatically read, write, and manipulate spreadsheet data to support your workflow automation needs.
+
+With Microsoft Excel integration, you can:
+
+- **Read Spreadsheet Data**: Access data from specific ranges, sheets, and cells
+- **Write and Update Data**: Add new data or modify existing spreadsheet content
+- **Manage Tables**: Create and manipulate tabular data structures
+- **Handle Multiple Sheets**: Work with multiple worksheets in a workbook
+- **Process Data**: Import, export, and transform spreadsheet data
+
+In Sim Studio, the Microsoft Excel integration provides seamless access to spreadsheet functionality through OAuth authentication. You can read data from specific ranges, write new information, update existing cells, and handle various data formats. The integration supports both reading and writing operations with flexible input and output options. This enables you to build workflows that can effectively manage spreadsheet data, whether you're extracting information for analysis, updating records automatically, or maintaining data consistency across your applications.
+{/* MANUAL-CONTENT-END */}
+
+
+## Usage Instructions
+
+Integrate Microsoft Excel functionality to manage spreadsheet data. Read data from specific ranges, write new data, update existing cells, and manipulate table data using OAuth authentication. Supports various input and output formats for flexible data handling.
+
+
+
+## Tools
+
+### `microsoft_excel_read`
+
+Read data from a Microsoft Excel spreadsheet
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `accessToken` | string | Yes | The access token for the Microsoft Excel API |
+| `spreadsheetId` | string | Yes | The ID of the spreadsheet to read from |
+| `range` | string | No | The range of cells to read from |
+
+#### Output
+
+| Parameter | Type |
+| --------- | ---- |
+| `data` | json |
+
+### `microsoft_excel_write`
+
+Write data to a Microsoft Excel spreadsheet
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `accessToken` | string | Yes | The access token for the Microsoft Excel API |
+| `spreadsheetId` | string | Yes | The ID of the spreadsheet to write to |
+| `range` | string | No | The range of cells to write to |
+| `values` | array | Yes | The data to write to the spreadsheet |
+| `valueInputOption` | string | No | The format of the data to write |
+| `includeValuesInResponse` | boolean | No | Whether to include the written values in the response |
+
+#### Output
+
+| Parameter | Type |
+| --------- | ---- |
+| `updatedRange` | string |
+| `updatedRows` | string |
+| `updatedColumns` | string |
+| `updatedCells` | string |
+| `metadata` | string |
+| `spreadsheetId` | string |
+| `spreadsheetUrl` | string |
+
+### `microsoft_excel_table_add`
+
+Add new rows to a Microsoft Excel table
+
+#### Input
+
+| Parameter | Type | Required | Description |
+| --------- | ---- | -------- | ----------- |
+| `accessToken` | string | Yes | The access token for the Microsoft Excel API |
+| `spreadsheetId` | string | Yes | The ID of the spreadsheet containing the table |
+| `tableName` | string | Yes | The name of the table to add rows to |
+| `values` | array | Yes | The data to add to the table \(array of arrays or array of objects\) |
+
+#### Output
+
+| Parameter | Type |
+| --------- | ---- |
+| `data` | json |
+
+
+
+## Block Configuration
+
+### Input
+
+| Parameter | Type | Required | Description | 
+| --------- | ---- | -------- | ----------- | 
+| `operation` | string | Yes | Operation |
+
+
+
+### Outputs
+
+| Output | Type | Description |
+| ------ | ---- | ----------- |
+| `response` | object | Output from response |
+| ↳ `data` | json | data of the response |
+| ↳ `metadata` | json | metadata of the response |
+| ↳ `updatedRange` | string | updatedRange of the response |
+| ↳ `updatedRows` | number | updatedRows of the response |
+| ↳ `updatedColumns` | number | updatedColumns of the response |
+| ↳ `updatedCells` | number | updatedCells of the response |
+| ↳ `index` | number | index of the response |
+| ↳ `values` | json | values of the response |
+
+
+## Notes
+
+- Category: `tools`
+- Type: `microsoft_excel`