> ## Documentation Index
> Fetch the complete documentation index at: https://docs.janet.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Documents

> Create and manage collaborative documents with Janet Agent, MCP, or the editor

Documents give you and your agents a shared place for specs, notes, and decisions. [Janet Agent](/agent) can work with them in chat, while connected MCP clients can use the [Janet MCP server](/mcpserver). Changes appear live when the document is open.

<div className="img-showcase img-showcase-lavender">
  <div className="qs-org-mock qs-org-mock-full">
    <div className="qs-main-area">
      <div className="doc-mock-header">
        <div className="doc-mock-header-left">
          <span className="doc-mock-back">
            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
              <path d="M19 12H5" />

              <path d="M12 19l-7-7 7-7" />
            </svg>
          </span>

          <span className="doc-mock-title">Push Notification Redesign</span>
          <span className="doc-mock-role">editor</span>
        </div>

        <div className="doc-mock-header-right">
          <div className="doc-mock-presence">
            <img className="doc-mock-presence-avatar" src="https://mintcdn.com/janetai-2e23a3d0/AicC1Vk0hC-6wzlT/headshot.jpeg?fit=max&auto=format&n=AicC1Vk0hC-6wzlT&q=85&s=988a826f2341ee7c6932a28952f470b4" alt="" width="400" height="400" data-path="headshot.jpeg" />

            <img className="doc-mock-presence-avatar" src="https://mintcdn.com/janetai-2e23a3d0/AicC1Vk0hC-6wzlT/adhit.jpg?fit=max&auto=format&n=AicC1Vk0hC-6wzlT&q=85&s=b73da57eff7a0da56c77a646fe8f33cb" alt="" width="400" height="400" data-path="adhit.jpg" />
          </div>

          <span className="doc-mock-icon-btn">
            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
              <path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2" />

              <path d="M9 11a4 4 0 1 0 0-8 4 4 0 0 0 0 8z" />
            </svg>
          </span>

          <span className="doc-mock-icon-btn">
            <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
              <path d="M12 15a3 3 0 1 0 0-6 3 3 0 0 0 0 6z" />

              <path d="M19.4 15a1.65 1.65 0 0 0 .33 1.82l.06.06a2 2 0 0 1-2.83 2.83l-.06-.06a1.65 1.65 0 0 0-1.82-.33 1.65 1.65 0 0 0-1 1.51V21a2 2 0 0 1-4 0v-.09A1.65 1.65 0 0 0 9 19.4a1.65 1.65 0 0 0-1.82.33l-.06.06a2 2 0 0 1-2.83-2.83l.06-.06A1.65 1.65 0 0 0 4.6 15a1.65 1.65 0 0 0-1.51-1H3a2 2 0 0 1 0-4h.09A1.65 1.65 0 0 0 4.6 9a1.65 1.65 0 0 0-.33-1.82l-.06-.06a2 2 0 0 1 2.83-2.83l.06.06A1.65 1.65 0 0 0 9 4.6a1.65 1.65 0 0 0 1-1.51V3a2 2 0 0 1 4 0v.09a1.65 1.65 0 0 0 1 1.51 1.65 1.65 0 0 0 1.82-.33l.06-.06a2 2 0 0 1 2.83 2.83l-.06.06A1.65 1.65 0 0 0 19.4 9a1.65 1.65 0 0 0 1.51 1H21a2 2 0 0 1 0 4h-.09a1.65 1.65 0 0 0-1.51 1z" />
            </svg>
          </span>
        </div>
      </div>

      <div className="doc-mock-editor">
        <div className="doc-mock-editor-h1">Push Notification Redesign</div>
        <div className="doc-mock-editor-h2">Overview</div>
        <div className="doc-mock-editor-p">Redesign the push notification system to support per-channel preferences and batched delivery. Related tickets: <span className="doc-mock-mention"><span className="doc-mock-mention-icon doc-mock-mention-icon-ticket"><svg width="9" height="9" viewBox="0 0 24 24" fill="white"><path d="M19 3H5c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h14c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zm-5 14H7v-2h7v2zm3-4H7v-2h10v2zm0-4H7V7h10v2z" /></svg></span>MOB-38</span> <span className="doc-mock-mention"><span className="doc-mock-mention-icon doc-mock-mention-icon-ticket"><svg width="9" height="9" viewBox="0 0 24 24" fill="white"><path d="M19 3H5c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h14c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zm-5 14H7v-2h7v2zm3-4H7v-2h10v2zm0-4H7V7h10v2z" /></svg></span>MOB-12</span></div>
        <div className="doc-mock-editor-h2">Requirements</div>
        <div className="doc-mock-editor-li">Users can toggle notifications per channel (Slack, email, in-app) <span className="doc-mock-cursor" style={{background:'#3b82f6'}}><span className="doc-mock-cursor-label" style={{background:'#3b82f6'}}>Will</span></span></div>
        <div className="doc-mock-editor-li">Batch low-priority alerts into a single daily digest</div>
        <div className="doc-mock-editor-li">Critical alerts (P0/P1) always deliver immediately</div>
        <div className="doc-mock-editor-h2">Open Questions</div>
        <div className="doc-mock-editor-li"><span className="doc-mock-mention"><img src="https://mintcdn.com/janetai-2e23a3d0/AicC1Vk0hC-6wzlT/adhit.jpg?fit=max&auto=format&n=AicC1Vk0hC-6wzlT&q=85&s=b73da57eff7a0da56c77a646fe8f33cb" alt="" className="doc-mock-mention-avatar" width="400" height="400" data-path="adhit.jpg" />Adhit Sankaran</span> — should we migrate existing prefs or reset to defaults? <span className="doc-mock-cursor" style={{background:'#f97316'}}><span className="doc-mock-cursor-label" style={{background:'#f97316'}}>Adhit</span></span></div>
        <div className="doc-mock-editor-li">Rate limit strategy for webhook delivery — see <span className="doc-mock-mention"><span className="doc-mock-mention-icon doc-mock-mention-icon-ticket"><svg width="9" height="9" viewBox="0 0 24 24" fill="white"><path d="M19 3H5c-1.1 0-2 .9-2 2v14c0 1.1.9 2 2 2h14c1.1 0 2-.9 2-2V5c0-1.1-.9-2-2-2zm-5 14H7v-2h7v2zm3-4H7v-2h10v2zm0-4H7V7h10v2z" /></svg></span>MOB-27</span></div>
        <div className="doc-mock-editor-li"><span className="doc-mock-mention"><img src="https://mintcdn.com/janetai-2e23a3d0/AicC1Vk0hC-6wzlT/headshot.jpeg?fit=max&auto=format&n=AicC1Vk0hC-6wzlT&q=85&s=988a826f2341ee7c6932a28952f470b4" alt="" className="doc-mock-mention-avatar" width="400" height="400" data-path="headshot.jpeg" />Will Barthell</span> to confirm API contract with mobile team</div>
      </div>
    </div>
  </div>
</div>

## Work with documents using agents

Ask Janet Agent to find a document or change one in natural language. MCP clients can use the same document capabilities directly.

| Task                                      | MCP tool                                 |
| ----------------------------------------- | ---------------------------------------- |
| List accessible documents                 | `list_documents`                         |
| Read a document                           | `get_document`                           |
| Create a private or organization document | `create_document`                        |
| Change the title or content               | `update_document`                        |
| Soft-delete or recover a document         | `delete_document` and `restore_document` |

Document tools follow your Janet permissions. An agent can only read documents you can access. Only the owner can delete or restore a document.

<Note>
  When you call `update_document` through MCP, send the complete Markdown body. The new content replaces the whole document rather than patching one section.
</Note>

### Use documents as agent context

The `search_tickets_semantic` tool includes document content when you search without a project filter. This lets an agent find relevant specs or meeting notes alongside tickets.

You can also attach a Janet document to a ticket with `add_context_to_tickets` by setting `type` to `document`. To show the same document under another page without moving it, use `add_document_shortcut`.

## Find and organize documents

Open **Documents** from the sidebar. Use **All**, **Private**, **Shared with Me**, or **Organization** to filter the list. Press **⌘K** to search by title or content. Press **c** to create a document.

Use folders to group related documents. Folders can be private or available to the organization, and their access rules apply to the documents inside them. You can nest folders or drag a document into one.

Synced [meeting notes](/integrations/note-takers) are grouped into read-only folders by provider. Documents created from a [brainstorm](/features/brainstorm) show a **Brainstorm** source badge.

## Edit and collaborate

Create a document from the **Create** menu, then choose **Private** or **Organization** visibility. The editor supports rich text and images. It also supports syntax-highlighted code blocks.

Type `/` to open formatting and embed commands. Type `@` to link tickets or other documents. You can also mention people and projects.

Other editors appear with live cursors. You can leave comments and filter them by open or resolved. Local edits sync after you reconnect if your connection drops.

## Share documents

Owners have full control. Editors can change content and invite other people, while viewers have read-only access. Organization documents are visible to everyone in the organization, and organization admins can edit them.