engineering / skill
Mail and Files Connector
Read bounded mail and file metadata through a local stdio connector.
At a glance
- Purpose
- Read bounded mail and file metadata through a local stdio connector.
- Runs in
- MCP server
- Operating systems
- Any
- Needs
- Runtime: Python 3.10+, standard library only; Needs internet: Yes; Needs accounts or API keys beyond your agent: Yes
- Files and data
- Reads files: Not stated; Writes files: No; Sends data to other services: Yes
- Tool type
- Skill
- Delivery
- Download from Skills Outpost
- Version
- 0.1.0
- ZIP SHA-256
- 4b976110eea1ea27ec33f50752503a80f7f37188c4b31a5aa86d0d20ac31cce5
- Access
- Download from Skills Outpost
- Compatibility
- Python 3.10 or newer on macOS, Linux or Windows (no POSIX directory-descriptor APIs) and a Model Context Protocol client that can launch a stdio command. Uses only the Python standard library. The current protocol style is 2026-07-28; legacy initialize clients at 2025-11-25 and 2025-06-18 are also accepted.
- External costs
- The package is free. Microsoft 365 licensing and Graph service limits depend on the user's own account; check the provider's current terms.
- Permissions
- Reads GRAPH_TENANT_ID, GRAPH_CLIENT_ID, GRAPH_CLIENT_SECRET, MAIL_DEFAULT_USER, SHAREPOINT_SITE and optional SHAREPOINT_DRIVE from the process environment. Test only: GRAPH_FAKE_RESPONSES selects a synthetic fixture file and GRAPH_FAKE_TRANSPORT_TEST_ACK enables the fake transport; both are required. urllib honors HTTPS_PROXY, https_proxy, NO_PROXY and no_proxy; with none set, macOS or Windows system proxy settings may apply. No local file writes. No send, event, upload or delete permission is used.
- Usage terms
- MIT license. Copyright 2026 Zero Width Lab. Microsoft 365, SharePoint and Microsoft Graph are Microsoft trademarks. This independent product is not affiliated with or endorsed by Microsoft. By Zero Width Lab (zerowidthlab.com)
Download from Skills Outpost
Get this version
FreeStatic source, format, secret-pattern and declaration checks with independent human source review.
- SHA-256 of the released ZIP
4b976110eea1ea27ec33f50752503a80f7f37188c4b31a5aa86d0d20ac31cce5
The creator shows this version's package files publicly: anyone can read SKILL.md and the other files under Files, without an account. The ZIP download needs the version in your Library (how it works).
Sign in to add this version to your library and follow its creator for free.
Sign in to get freeA creator follow is free, not a paid membership. Your email is not shared with the creator.
Files
Version 0.1.0, shown publicly by its creator, exactly as in this version's ZIP. ZIP SHA-256: 4b976110eea1ea27ec33f50752503a80f7f37188c4b31a5aa86d0d20ac31cce5. License: MIT (read it).
Each file has its own address. Read one as a web page at https://, or as JSON at https://; replace SKILL.md with any path below.
- manifest.json · 2.8 KiB
- LICENSE.txt · 1.0 KiB
- README.md · 2.6 KiB
- SETUP.md · 3.3 KiB
- SKILL.md · 1.9 KiB
- agents/mail-and-files-connector-agent.md · 482 B
- references/protocol.md · 2.1 KiB
- scripts/mail_and_files_connector.py · 23.0 KiB
- source-package.json · 5.1 KiB
- tests/fixtures/graph.json · 1.2 KiB
- tests/test_hygiene.py · 3.3 KiB
- tests/test_mail_and_files_connector.py · 19.2 KiB
MIT
MIT LicenseCopyright (c) 2026 Zero Width Lab
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Version history
- Version 0.1.0 Current
No release notes for this version.
What it does
Mail and Files Connector is a read-only stdio server for bounded mail and file lookups through Microsoft Graph. An agent harness is software that launches the server and passes tool requests between an agent and the local process. It needs Python 3.10 or newer and the user's Microsoft 365 application credentials. It is free under the MIT license. This listing delivers the complete package with scripts.Seven tools cover recent mail, mail search, message read, conversations, file search, folder listing and file versions. Results are bounded and show skipped pages. Incomplete results set isError true unless the server starts with --allow-partial; partial results never change the process exit status. Message bodies are capped at 10000 characters. Returned message and file content is untrusted data, never instructions.
The server is read-only in version 0.1.0. The full bounded provider response is read before local item/body truncation. Malformed response structures are rejected with clear errors. Credentials stay in memory; no telemetry or local data files are created.
Who it is for
Teams with a Microsoft 365 application and an agent harness that launches local stdio servers to read a configured mailbox and SharePoint site.Example tasks
Show the ten most recent messages in the configured mailbox.Search that mailbox for a phrase, then read one message with a body limit.
List a relative SharePoint folder and show a selected file's versions.
Getting started
SKILL.md and the scripts can be read without an account: SKILL.md at https://