Excel MCP integration for AI agents.
Connect AI agents to Excel through 31 structured actions, including get range, add table, delete table column, and apply table filter. Review authentication…
- ACTION CONTRACTS
- 31
- AUTHENTICATION
- OAuth 2.0
- SOURCE STATUS
- Provider-backed
CATALOG SOURCE REVIEWED AUGUST 23, 2026 / ACTION NAMES AND SCHEMAS DERIVED FROM WORKING MACHINES PROVIDER SOURCE
CAPABILITY PROFILE
What the Excel integration exposes
The Excel Agent App exposes 31 provider-backed actions for productivity and data work. Its current contract lets an authorized agent read one worksheet range by a1-style address, create a new workbook table from an address range, and delete one column from a workbook table. These operations are called through Working Machines as typed capabilities rather than through browser navigation or copied UI steps.
A connection uses OAuth 2.0. Before execution, the agent can inspect the selected action, its required fields, declared scopes, and expected output contract. Provider credentials remain inside the Working Machines runtime; the calling agent receives the capability and its structured result, not the underlying secret.
For reliable operation, start with the narrowest action that satisfies the task, resolve stable provider identifiers before changing state, and validate the returned object or status after execution. Availability still depends on the connected Excel account, granted provider permissions, workspace policy, region, plan, and upstream API behavior.
VERIFIED ACTION SAMPLE
Real Excel capabilities.
Showing 12 of 31 actions. Risk labels are conservative signals based on operation names, not substitutes for provider documentation or runtime policy.
get_rangeREADRead one worksheet range by A1-style address.
INPUTS: itemId / driveId / sessionId / worksheetId / address
add_tableWRITECreate a new workbook table from an address range.
INPUTS: itemId / driveId / sessionId / worksheetId / address
delete_table_columnHIGH IMPACTDelete one column from a workbook table.
INPUTS: itemId / driveId / sessionId / tableId / columnId
apply_table_filterREVIEWApply a Microsoft Graph filter criteria object to one table column.
INPUTS: itemId / driveId / sessionId / tableId / columnId
add_table_columnWRITEAdd one column to a workbook table.
INPUTS: itemId / driveId / sessionId / tableId / index
add_table_rowWRITEAdd one or more rows to a workbook table.
INPUTS: itemId / driveId / sessionId / tableId / index
add_worksheetWRITEAdd a new worksheet to a workbook.
INPUTS: itemId / driveId / sessionId / name
apply_table_sortREVIEWApply a Microsoft Graph sort definition to one workbook table.
INPUTS: itemId / driveId / sessionId / tableId / fields
clear_rangeREVIEWClear one worksheet range.
INPUTS: itemId / driveId / sessionId / worksheetId / address
clear_table_filterREVIEWClear the current Microsoft Graph filter on one table column.
INPUTS: itemId / driveId / sessionId / tableId / columnId
convert_table_to_rangeREVIEWConvert a workbook table back into a plain worksheet range.
INPUTS: itemId / driveId / sessionId / tableId
create_sessionWRITECreate an Excel workbook session for subsequent workbook operations.
INPUTS: itemId / driveId / sessionId / persistChanges
INPUT CONTRACTS
Know what the action needs before it runs.
get_range
itemIdREQUIRED- Workbook drive item ID.
driveIdOPTIONAL- Optional drive ID. Leave empty to use the current user's default OneDrive.
sessionIdOPTIONAL- Optional workbook session ID created by create_session.
worksheetIdREQUIRED- Worksheet name or worksheet ID.
addressREQUIRED- Excel A1-style range address.
add_table
itemIdREQUIRED- Workbook drive item ID.
driveIdOPTIONAL- Optional drive ID. Leave empty to use the current user's default OneDrive.
sessionIdOPTIONAL- Optional workbook session ID created by create_session.
worksheetIdOPTIONAL- Worksheet name or worksheet ID.
addressREQUIRED- Excel A1-style range address.
delete_table_column
itemIdREQUIRED- Workbook drive item ID.
driveIdOPTIONAL- Optional drive ID. Leave empty to use the current user's default OneDrive.
sessionIdOPTIONAL- Optional workbook session ID created by create_session.
tableIdREQUIRED- Table name or table ID.
columnIdREQUIRED- Table column name or table column ID.
apply_table_filter
itemIdREQUIRED- Workbook drive item ID.
driveIdOPTIONAL- Optional drive ID. Leave empty to use the current user's default OneDrive.
sessionIdOPTIONAL- Optional workbook session ID created by create_session.
tableIdREQUIRED- Table name or table ID.
columnIdREQUIRED- Table column name or table column ID.
PROVIDER-SPECIFIC WORKFLOWS
Jobs this Agent App can support
Inspect Get Range
Read one worksheet range by A1-style address. Use this as a bounded discovery step, retain the returned identifier, and avoid expanding the read beyond the task's stated scope.
get_rangeControl Add Table
Create a new workbook table from an address range. Resolve the target first, present material changes for confirmation, and make retries idempotent where the provider supports it.
add_tableVerify with Add Table
Create a new workbook table from an address range. Compare the returned provider state with the intended outcome and preserve stable IDs or canonical links in the run record.
add_tableSAFETY BOUNDARY
Operate Excel with explicit limits
- Authorize Excel with OAuth 2.0 and grant only the provider access required by the selected actions.
- 13 actions are change-capable by name. Confirm the target identity and material parameters before allowing a write.
- Treat `delete_table_column`, `delete_table_row`, and `delete_worksheet` as high-impact operations and require an explicit approval boundary.
- The sampled contract declares provider scopes including `Files.ReadWrite`; verify the complete action contract before execution.
- After a call, inspect the structured result and execution record before reporting that the Excel task completed successfully.
CONNECTION MODEL
OAuth 2.0
Excel uses OAuth 2.0. Connection requirements and availability are determined by the provider and the Working Machines deployment.
Working Machines stores provider credentials behind the execution boundary. An agent can use an authorized connection identity, but catalog discovery alone does not reveal OAuth tokens, API keys, or provider secrets.
- READ SIGNALS
- 11
- WRITE SIGNALS
- 10
- HIGH IMPACT
- 3
- REVIEW SIGNALS
- 7
EVIDENCE AND AVAILABILITY
Provider reference
Action names, input fields, authentication types, and counts on this page are generated from the Working Machines provider catalog. Provider behavior, quotas, object semantics, account eligibility, and regional availability remain governed by Excel.