conecto. Get started
Microsoft 365

Read a OneDrive file

m365_files_read · Reads only · Markdown

A OneDrive file's words: text, PDF, Word, Excel or PowerPoint, up to 5 MB.

Free*

*Free up to 1,000,000 reads a month for the whole account, then $0.50 per 10,000 reads.

An example

What does the returns policy say about used equipment?

Your agent callsm365_files_readFree*

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "mailbox": "support@hansenvoss.example",
  "file_id": "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K"
}
What comes back
{
  "mailbox": "support@hansenvoss.example",
  "file": {
    "id": "01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K",
    "name": "Returns policy.txt",
    "size": 182,
    "folder": false,
    "type": "text/plain",
    "modified_at": "2026-09-02T10:12:00Z",
    "link": "https://hansenvoss-my.sharepoint.com/personal/support/Documents/Returns%20policy.txt",
    "text": "Returns policy\n\nEquipment can be returned within 30 days in its original packaging. We collect it for free; the refund follows within 5 working days of collection."
  }
}

Use it when

A search found the document and the agent needs what it says.

What it does

A file's words, up to 5 MB: text, PDF, Word, Excel and PowerPoint files are read in a separate, capped process. Free.

What comes back

mailbox; file: id, name, size, type, modified_at, link and text. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
mailboxstringOne of the mailboxes the agent may act as; optional when only one is connected. Up to 254 characters.
file_idRequiredstring1 to 400 characters.

The call

Over MCP, call m365_files_read on https://api.conecto.chat/mcp/microsoft365. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/m365_files_read \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mailbox":"support@hansenvoss.example","file_id":"01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
not_connected409Microsoft 365 isn't connected yet.Connect it with m365_connect.
not_allowed403The mailbox is not one the agent may act as.Use a connected mailbox; the owner adds one by connecting again.
not_found404Microsoft 365 has no such message, event or file.Search first and use its id.
too_large413The file is over 5 MB.Open it at its link.
unsupported_type400The file is not text, PDF or Office.Open it at its link.

More Microsoft 365 tools

All 11 tools

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md