Mailbox Sharing & Collaboration

Mailboxes don’t have to belong to a single person. With mailbox sharing, you can give teammates access to a mailbox so everyone can view incoming documents, review extracted data, and keep the pipeline moving — without sharing a single login.

---

How Sharing Works

• A mailbox is owned by the account that created it. The owner can grant other DocsToSheets users access to that mailbox by their email address.
• Once shared, the mailbox appears in the recipient’s workspace under Your Mailboxes, marked with a Shared badge so it’s clear they don’t own it.
• Shared collaborators work against the same mailbox as the owner: they see the same inbound address, the same Document Registry, and the same Spreadsheet Row Ledger (the parsed data view).
• Sharing is independent of the inbound email address — the mailbox keeps its existing [mailbox-slug]+[account-slug]@in.docmail.app address regardless of who it’s shared with.

---

Share a Mailbox

1. Open the mailbox you want to share from your DocsToSheets dashboard.
2. Open its sharing controls and add a collaborator by their email address (the address they use to sign in to DocsToSheets).
3. The mailbox immediately becomes available in that user’s workspace, labeled Shared.

To stop sharing, remove the collaborator from the same sharing controls; their access is revoked right away.

---

Sharing vs. Authorized Senders

These two features are easy to confuse — they control different things:

• Mailbox sharing decides who can see and work with the mailbox inside DocsToSheets (viewing documents, extractions, and data).
• The Authorized Senders allowlist decides which email addresses are permitted to send documents into the mailbox for processing.

Adding someone as a collaborator does not automatically authorize their email address to submit documents, and vice-versa. Configure each one for the behavior you need.

---

Manage Sharing Programmatically (MCP)

If you’ve connected DocsToSheets to an AI assistant via the MCP Server, you can manage sharing conversationally with these tools:

• mailbox_shares_list(mailboxId): Lists all users who currently have shared access to the mailbox.
• mailbox_shares_create(mailboxId, email): Shares the mailbox with another user’s email address.
• mailbox_shares_delete(mailboxId, shareId): Revokes a share and removes that user’s access.

All three require the mcp.write scope.