How to integrate Excel MCP with Hermes

Connect Hermes to Excel MCP. Add sales data row to q2 table, create bar chart from revenue column, and more using natural language, with authentication handled for you.

Excel logoExcel
Oauth2S2s Oauth2

Microsoft Excel is a robust spreadsheet application for organizing, analyzing, and visualizing data. It's the go-to tool for calculations, reporting, and flexible data management.

119 Tools

Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Excel account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

Also integrate Excel with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Excel with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Excel

Ask your agent to connect to Excel, or simply request any Excel-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Excel connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Excel or request any Excel-related task. It will prompt you to authenticate and authorize access.

5. Done!

What is the Excel MCP server, and what's possible with it?

The Excel MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Excel account. It provides structured and secure access to your spreadsheets, so your agent can perform actions like adding data, creating tables, managing worksheets, generating charts, and sharing workbooks on your behalf.

  • Automated data entry and updates: Let your agent add rows, columns, or clear specific ranges in any worksheet—keeping your data fresh, organized, and accurate.
  • Effortless table and worksheet management: Direct your agent to create tables, add new worksheets, or organize data structures for seamless tracking and reporting.
  • Dynamic chart generation: Have your agent visualize your data instantly by adding charts to any worksheet for quick insights and analysis.
  • Advanced filtering and sorting: Ask your agent to apply filters or custom sorts to tables, making it easy to focus on what matters most in your datasets.
  • Secure sharing and permission control: Empower your agent to grant access or update permissions on workbooks, ensuring your team can collaborate safely and efficiently.

Way Forward

With Excel connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

TOOLS

Supported Tools

Every Excel action and event your agent gets out of the box.

Add Chart

Add a chart to a worksheet using Microsoft Graph API.

Add Named Item

Add Named Item

Add SharePoint Worksheet

Add a new worksheet to a SharePoint Excel workbook using Microsoft Graph Sites API.

Add Table

Create a new table in a worksheet using the Microsoft Graph API.

Add Table Column

Add a column to a table using Microsoft Graph API.

Add Table Row

Add a row to a table using Microsoft Graph API.

Add Workbook Permission

Tool to grant access to a workbook via invite.

Add Worksheet

Add a new worksheet to an Excel workbook using Microsoft Graph API.

Apply Table Filter

Apply a filter to a table column using Microsoft Graph API.

Apply Table Sort

Apply a sort to a table using Microsoft Graph API.

Autofit Range

Autofit columns or rows intersecting a workbook range.

Calculate Workbook Function

Run one allowlisted Microsoft Graph v1.

Calculate Excel Workbook

Calculate Excel Workbook

Clear Range

Tool to clear values, formats, or contents in a specified worksheet range.

Clear Table Filter

Clear a filter from a table column using Microsoft Graph API.

Clear All Table Filters

Clear All Table Filters

Clear Table Sort

Clear Table Sort

Close Excel Session

Tool to close an existing Excel workbook session.

Convert Table To Range

Convert a table to a range using Microsoft Graph API.

Copy Drive Item

Create a non-destructive asynchronous copy of a file or folder.

Create Folder

Create a folder under a parent Microsoft Graph drive item.

Create Workbook

Tool to create a new Excel workbook file at a specified drive path.

Delete Drive Item

Move a OneDrive or SharePoint drive item to the recycle bin by item ID.

Delete Named Item

Permanently delete a workbook-scoped named item; this cannot be undone.

Delete Range

Delete worksheet cells and shift the remaining cells up or left.

Delete Table

Permanently delete an Excel table by its ID or name.

Delete Table Column

Delete a column from a table using Microsoft Graph API.

Delete Table Row

Delete a row from a table using Microsoft Graph API.

Delete Worksheet

Tool to delete a worksheet from the workbook.

Download Workbook

Download an Excel workbook in its original file format.

Export Workbook to PDF

Tool to export an Excel workbook to PDF via Microsoft Graph's format conversion.

Get Excel Application

Get Excel Application

Get chart

Get chart

Get Chart Axis

Tool to retrieve a specific axis from a chart.

Get chart component

Get chart component

Get Chart Data Labels

Tool to retrieve the data labels object of a chart.

Get chart image

Get chart image

Get Chart Legend

Tool to retrieve the legend object of a chart.

Get chart point

Get chart point

Get chart series

Get chart series

Get Comment

Retrieve one workbook comment by its exact ID.

Get Comment Reply

Retrieve one reply to a workbook comment by its exact ID.

Get Derived Range

Return a range derived from another range by navigation or geometry.

Get Drive Item

Retrieve OneDrive or SharePoint drive item metadata by exact ID or path.

Get Named Item

Retrieve a workbook-scoped named item by exact name.

Get Named Item Range

Get Named Item Range

Get Excel Operation Status

Get Excel Operation Status

Get Pivot Table

Get Pivot Table

Get Projected Worksheet Subresource

Read selected properties from a worksheet range, its used range, or worksheet protection.

Get Range

Get a range from a worksheet using Microsoft Graph API.

Get Range Format

Read one formatting component from a workbook range.

Create Excel Session

Create a session for an Excel workbook using Microsoft Graph API.

Get SharePoint Range

Get a range from a worksheet in SharePoint using Microsoft Graph Sites API.

Get SharePoint Worksheet

Get a worksheet by name or ID from a SharePoint Excel workbook using Microsoft Graph Sites API.

Get Table

Retrieve one workbook- or worksheet-addressed table by ID or exact name.

Get table column

Tool to retrieve a specific column from a workbook table.

Get Table Column Cell

Read one cell by row within a selected table column's data body.

Get Table Column Range

Get Table Column Range

Get Table Range

Get Table Range

Get Table Row

Get Table Row

Get Table Row Range

Get Table Row Range

Get Table Sort

Get Table Sort

Get Visible Range

Read cells visible after worksheet filtering.

Get workbook

Tool to retrieve the properties and relationships of a workbook.

Get Worksheet

Get a worksheet by name or ID from an Excel workbook using Microsoft Graph API.

Get Worksheet Protection

Get Worksheet Protection

Get Worksheet Row Range

Read a zero-based worksheet row bounded to columns containing values.

Get Worksheet Used Range

Tool to retrieve a worksheet's used range (active data region) without specifying a fixed range address.

Insert Range

Tool to insert a new cell range into a worksheet, shifting existing cells down or right.

List chart points

List chart points

List Charts

List charts in a worksheet using Microsoft Graph API.

List Chart Series

Tool to list all data series in a chart.

List Comment Replies

List replies to one workbook comment.

List Comments

Tool to list comments in an Excel workbook.

List Drive Item Children

Tool to list immediate children (files/folders) of a folder DriveItem using driveId and itemId.

List Drive Item Versions

List retained versions of a OneDrive or SharePoint workbook file.

List Drive Files

List files and folders in a drive root or specified path.

List Named Items

List named items in a workbook using Microsoft Graph API.

List Pivot Tables

List Pivot Tables

List SharePoint Tables

List tables in a SharePoint worksheet using Microsoft Graph Sites API.

List SharePoint Worksheets

List worksheets in an Excel workbook stored in SharePoint using Microsoft Graph Sites API.

List Site Lists

List SharePoint lists in a known Microsoft Graph site.

List Table Columns

List columns in a table using Microsoft Graph API.

List Table Rows

List rows in a table using Microsoft Graph API.

List Tables

List tables in a worksheet using Microsoft Graph API.

List Workbook Permissions

Tool to list permissions set on the workbook file.

List Worksheets

List worksheets in an Excel workbook using Microsoft Graph API.

Merge Cells

Merge cells in a worksheet range using Microsoft Graph API.

Protect Worksheet

Tool to protect a worksheet using optional protection options.

Reapply All Table Filters

Reapply All Table Filters

Reapply Table Sort

Reapply Table Sort

Refresh Pivot Tables

Refresh Pivot Tables

Refresh Excel Session

Refresh Excel Session

Run Graph Mutation Batch

Create, update, or delete drive or workbook resources in up to 20 requests; inspect every subresponse status because individual mutations can fail.

Run Graph Read Batch

Read drive or workbook data in up to 20 GET requests; inspect every subresponse status because individual requests can fail.

Search Drive Files

Tool to search OneDrive drive items by query to discover Excel workbook IDs.

Search Microsoft 365 Content

Search OneDrive and SharePoint content using Microsoft Search.

Search Sites

Search SharePoint sites by free-text query for workbook discovery.

Set chart data

Set chart data

Set chart position

Set chart position

Sort Range

Sort a range in a worksheet using Microsoft Graph API.

Unmerge Range

Split a merged worksheet range back into separate cells.

Unprotect Worksheet

Remove protection from a worksheet so it can be edited again.

Update Chart

Update a chart in a worksheet using Microsoft Graph API.

Update chart component

Update chart component

Update Chart Legend

Tool to update formatting or position of a chart legend.

Update chart series

Rename one Excel chart series by ID or zero-based collection position.

Update Drive Item

Rename, move within the same drive, or update client timestamps for a DriveItem by stable ID.

Update Named Item

Update a workbook named item's visibility or comment.

Update Range

Update a range in a worksheet using Microsoft Graph API.

Update Range Format

Update exactly one formatting component on a workbook range.

Update SharePoint Range

Update a range in a SharePoint worksheet using Microsoft Graph Sites API.

Update Table

Update a table in a workbook using Microsoft Graph API.

Update Table Column

Update Table Column

Update Table Column Range

Update raw values in a table column's data-body cells by zero-based index.

Update Table Row

Update Table Row

Update Worksheet

Update worksheet properties (name, position) in an Excel workbook using Microsoft Graph API.

Upload Workbook from URL

Tool to upload an external Excel file from a URL into OneDrive/SharePoint.

Who Am I

Return the identity (email, name) of the connected Excel (Microsoft) account.

FAQ

Frequently asked questions

With a standalone Excel MCP server, the agents and LLMs can only access a fixed set of Excel tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Excel and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Excel tools.

Yes, absolutely. You can configure which Excel scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Excel data and credentials are handled as safely as possible.

Start with Excel.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Excel tool your agent needs.Free to start.

Start building