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

# MCP Overview

> Your notes, searchable and writable by AI assistants

Dexi runs a [Model Context Protocol](https://modelcontextprotocol.io) server — the same notes, search, and capture engine as the app, exposed as tools any MCP client can call. Connect Claude, ChatGPT, Cursor, or your own agent and it can answer from what you've actually read and saved, file new notes as you work, and quiz you on your review deck.

```
https://mcp.dexi.net/mcp
```

Transport is **streamable HTTP**; auth is **OAuth 2.1** with browser consent — no API keys to paste. Every content kind is covered: typed notes, saved bookmarks, forwarded emails, and feed articles are all note-backed, so one `search_notes` call spans your whole workspace.

* [Getting Started](/mcp/getting-started) — connect from Claude, ChatGPT, Cursor, VS Code, Goose
* [Tools](/mcp/tools) — all twelve tools with parameters and return shapes
* [Examples](/mcp/examples) — flows agents run well
* [OAuth](/mcp/oauth) — protocol details for MCP client builders

<Note>
  Don't confuse the two MCP endpoints: `mcp.dexi.net/mcp` is **your notes**
  (this page's subject, OAuth-gated). `docs.dexi.net/mcp` is a separate
  read-only server that searches **this documentation site** — Mintlify hosts
  one for every docs site, no account needed.
</Note>

## Scopes

| Scope         | Grants                                                                                                               |
| ------------- | -------------------------------------------------------------------------------------------------------------------- |
| `notes:read`  | search\_notes, semantic\_search, list\_notes, get\_note, find\_similar, list\_tags, list\_folders, get\_due\_reviews |
| `notes:write` | create\_note, update\_note, delete\_note, grade\_review                                                              |

Clients typically request both; the consent page shows what was asked. Disconnect any client in **Settings → Connected apps**.

Scopes say what a connection may *do*; the consent page also lets you limit what it may *touch* — everything, one folder, one tag, or a tag within a folder — per connection, editable any time in Settings → Connected apps, applied on the connection's next request. Details: [access restrictions](/mcp/oauth#access-restrictions).

## Teams and privacy

If you're on a team, read tools see your own notes **plus teammates' team-shared notes** (marked `"shared": true` with an `owner` name in results). Write tools work only on your own notes — a connected assistant can never modify a teammate's note. Your folder assignments stay private; teammates' shared notes carry no folder information.