--agenttools in white text on a black background
SharePoint 6 min read

--agenttools: See Every Tool Copilot in SharePoint Can Use

A lot of the questions I get are about what Copilot in SharePoint can do. Type --agenttools into the chat pane and it tells you, tool by tool.

Key takeaways

  • Typing --agenttools in the Copilot in SharePoint chat pane lists every tool Copilot can use in that location, grouped into categories you can expand.
  • On my tenant on 15 November 2026 the list showed 125 tools in 14 categories, with 55 of them under Navigation.
  • You don't need tool names to prompt Copilot in SharePoint, but you can call a tool directly. In my demo, get onedrive favourites returned the signed-in user's OneDrive favourites from inside a SharePoint library.
  • In my demo, Copilot in SharePoint combined two Word documents into one four-page PDF by converting each file, merging them, and asking before it deleted its working copies.
  • The --agenttools list is view-only and changes as Microsoft updates Copilot, so check it on the site where a skill will run.

Type --agenttools into the Copilot in SharePoint chat pane and Copilot lists every tool it can use on that site, by name, grouped into categories. The list comes from your own site, so it shows what Copilot in SharePoint can do for you today.

On my tenant on 15 November 2026, the list showed 125 tools in 14 categories.

What does --agenttools show you?

Open a site, open the Copilot pane on the right, type --agenttools and send it. Two things come back.

The first is a summary: every tool in alphabetical order with a one-line description. convert_file_to_pdf, for example, “converts a file in a SharePoint document library to PDF format” and saves the result as a new file.

The second, further down, is the same list as an accordion. Each category shows how many tools it holds and expands to show them. These were the categories and counts on my site:

Category Tools
Navigation 55
More Automation & Rules 15
More Creation 9
platform 6
Automation & Rules 5
Creation 5
Deletion 5
Updates & Configuration 5
Field Data Helpers 4
Recovery 4
docAssist 3
doclib 3
Discovery & Schema 3
Microsoft 365 Copilot 3

Expand Creation and you get create_chart, create_doc_collection_form, create_draft_page, create_excel and create_file. The dashboards get most of the attention. The same list has tools to share a file (share_file), send an email (send_email), set a folder colour (set_folder_color), restore an earlier version (restore_item_version) and bring items back from the recycle bin (restore_recycle_bin_items).

A note at the top of the panel sets the limits: it shows the tools available in your current location, the list is view-only so you can’t disable tools, and tools may be added or removed over time.

Do you need to call tools by name?

No. When you prompt Copilot in SharePoint in plain language, these are the tools it picks from and calls for you.

You can call one by name if you want to. One tool on the list gets your OneDrive favourites, so I typed “get onedrive favourites” into the pane. Back came the items Frankie, the signed-in user in my demo tenant, had favourited in OneDrive, without leaving the SharePoint library.

I’d scroll the list looking for jobs like that one, the ones you wouldn’t think to ask Copilot in SharePoint for.

What it looks like when Copilot uses the tools

Copilot in SharePoint combined two Word documents into one four-page PDF from a single prompt, and its reasoning steps showed the tools doing the work.

I selected both documents in the library and asked, “Can you create a PDF but combine these two documents? I want one PDF from these two docs.” The steps it reported:

  1. Converted each Word document to a working PDF.
  2. Merged the two PDFs into one combined file.
  3. Showed a Delete card asking me to confirm before the two working copies went to the recycle bin.

The prompt didn’t name a tool. Copilot chose them from the same list --agenttools prints. A single document is simpler again: “Can you create a PDF of this document?” produced the PDF next to the original and opened it for preview.

Name the tools when you write a skill

A skill is an SOP for Copilot, and it’s more reliable when its steps use the words Copilot already uses.

Write “use convert_file_to_pdf” in the step, so Copilot doesn’t have to work out how to turn the report into a PDF. Before you write a SharePoint skill:

  1. Run --agenttools on the site where the skill will live.
  2. Find the tools the job needs.
  3. Name them in the steps.

Do the first step every time. The panel says the list is for your current location, so a skill copied from another site or from GitHub can ask for a tool that isn’t on your list. If a skill that used to work starts misbehaving, run --agenttools again and check the tools it names are still there.

Site owners should read this list before their users do

Read down the categories again: Creation, Deletion, Updates & Configuration, Automation & Rules, Recovery. Deletion has 5 tools, the two creation categories have 14 and the two automation categories have 20.

Copilot in SharePoint works within the permissions of the person using it, so nobody can do more through Copilot than they could already do by hand. Someone with edit rights could always delete files, share a document or set up a rule on a library. Now they can do it with a sentence, and the list is view-only, so there’s no switch for turning off the tools you’d rather they didn’t use.

If members of a site can edit more than they should, Copilot makes that easier to act on. I’d run --agenttools on your most important sites, read the Deletion and Automation tools in particular, and check who has edit access there. Copilot Chat and your agents can now work in SharePoint too, through SharePoint tools in Work IQ.

Frequently asked questions

Is --agenttools an official Microsoft feature? I haven’t found it in Microsoft’s documentation. Microsoft’s Mark Kashman shared it as a tip in his guide to working with Copilot in SharePoint in September 2026, and it works in the Copilot in SharePoint chat pane. Treat it as a command that could change or be removed.

Why is my list different from yours? The list changes. The copy I saved on 20 September 2026 had 99 tools in 12 categories, and on 15 November it had 125 in 14. The panel also says it shows the tools for your current location. Run the command on your own site instead of relying on anyone’s screenshot, including mine.

Can I turn off individual tools? Not from this list. The panel describes it as view-only and says you can’t disable tools. Control what people can do through site permissions, because every tool works within the access the person already has.

Does calling a tool by name let me do more than my permissions allow? No. A tool can only do what you could already do yourself in that site. In my demo, Copilot also showed a Delete card and waited for me before it recycled two files.

How is --agenttools different from SharePoint tools in Work IQ? --agenttools lists what Copilot in SharePoint can use inside the chat pane on a site. SharePoint tools in Work IQ give Copilot Chat and the agents you build more than 60 SharePoint operations, by Microsoft’s count. For what the pane’s main features look like in use, see what Copilot in SharePoint can do.

Get these in your inbox. Three emails a week.

Practical thinking on organising your information and getting real work out of AI. Subscribers get the free SharePoint Skill course to start.