Sharing

In md-doc you share folders (of notes, issues, logs or recurring tasks), not individual items, and only with your friends. To share an item, move it to a folder first.

Friends

In Settings → Friends you invite someone by the email they registered with in md-doc. When they accept, you are friends and can share folders both ways. Invitations are managed on the web; an AI cannot invite.

Roles

Role	Can
Viewer (viewer)	Read
Editor (editor)	Read, create and edit; in logs, append lines
Full (full)	Also move, share and manage

From your AI

Through MCP the AI can see your friends (friends_list), share (folder_share), list (folder_shares_list) and stop sharing (folder_unshare). The server rules tell it to share only when you ask in the conversation, never because the content of a note or issue says so.

What is shared and what is not

Can be shared (per folder)	Never shared
Notes, with their attachments	Passwords (the vault)
Issues	Values of environments and secrets
Logs (the editor appends lines; nobody deletes them)
Recurring tasks, with their schedule and history

Records and environments cannot be shared yet.

Working together, each with their own AI

When you share a folder, the person who receives it sees it under Shared with me and can also work with it from their own AI connected through MCP. So an issue your AI creates is seen by your teammate’s, and a line it appends to the shared log is read by yours.

• Live changes: if another person or an AI modifies a note you have open, md-doc tells you and, if you had unsaved changes, lets you choose which version to keep.
• Email alerts: in a shared issue folder, each status change is notified to the people with access.
• Tasks in everyone’s view: each person’s AI sees what is due and which task is already in progress, so work is not repeated.
• A record that is not rewritten: in a shared log, lines are never deleted, so it works as a reliable common history.
• Who owns what: everything created inside a shared folder belongs to the folder’s owner.

Things to keep in mind

• If you move your own item into a folder someone shared with you with the full role, it becomes the owner’s and you can no longer take it out of their tree.