# Spote

## Docs

- [Authenticate with the Spote API](https://docs.spote.cloud/api/authentication.md): Authenticate Spote API and MCP requests by passing a Personal Access Token as a Bearer token in the Authorization header on every request.
- [Buckets and Tags API endpoints](https://docs.spote.cloud/api/buckets-tags.md): GET /api/buckets lists all your folder names. GET /api/tags returns tags with note counts, optionally filtered by bucket. Useful for building integrations.
- [Files API — upload and retrieve attachments](https://docs.spote.cloud/api/files.md): Upload file attachments via POST /api/upload and retrieve them via GET /api/files/:key. Files are private to your account and served through a secure proxy.
- [Notes API — create, read, update, delete](https://docs.spote.cloud/api/notes.md): REST endpoints for Spote notes: create, list with bucket and tag filters, get by ID, update with conflict detection, and delete. Embeddings are auto-generated.
- [Spote REST API overview](https://docs.spote.cloud/api/overview.md): The Spote REST API gives you full programmatic access to notes, semantic search, file uploads, collaboration shares, and Personal Access Token management.
- [Search and discover notes via the API](https://docs.spote.cloud/api/search.md): Use GET /api/notes/search for natural language semantic search, GET /api/notes/similar/:id for related notes, and GET /api/notes/shared for shared notes.
- [Shares API — invite and manage collaborators](https://docs.spote.cloud/api/shares.md): Invite users to a specific note by email via POST /api/notes/:id/shares. Set read or write permission, list all invitations, and revoke access at any time.
- [Personal Access Tokens API](https://docs.spote.cloud/api/tokens.md): Create, list, and revoke Personal Access Tokens via the API. Tokens authenticate REST API and MCP requests. The raw token value is returned only at creation.
- [Organize notes with buckets and tags](https://docs.spote.cloud/concepts/buckets-and-tags.md): Buckets are named folders for grouping notes. Tags are extracted automatically from #hashtags in your note text and let you filter across all buckets.
- [What is a note in Spote?](https://docs.spote.cloud/concepts/notes.md): A Spote note contains a title, markdown body, bucket, auto-extracted tags, and attachments. Learn note structure, access levels, and conflict detection.
- [Semantic search: find notes by meaning](https://docs.spote.cloud/concepts/semantic-search.md): Spote searches by idea, not exact keywords. Find notes with natural language even when you can't recall the phrasing you used. Also available via the REST API.
- [Connect an AI agent to Spote via MCP](https://docs.spote.cloud/connecting-ai-agents.md): Link any MCP-compatible AI assistant to your Spote account so it can save, search, and retrieve your notes during a conversation without switching apps.
- [Create and manage Personal Access Tokens](https://docs.spote.cloud/guides/personal-access-tokens.md): Personal Access Tokens let AI agents and scripts authenticate with Spote. Create and revoke tokens independently per integration from the Settings page.
- [Install Spote as an app on your device](https://docs.spote.cloud/guides/pwa-install.md): Install Spote as a Progressive Web App on Android, iOS, or desktop for a native experience. Use the share sheet to send content directly into a new note.
- [Share notes with teammates in Spote](https://docs.spote.cloud/guides/sharing-notes.md): Invite collaborators to a specific note via email. Choose read-only or write access. Spote sends an invite link and the recipient accepts it to gain access.
- [Write and edit notes in Spote](https://docs.spote.cloud/guides/writing-notes.md): Use Spote's WYSIWYM markdown editor to write rich notes with headings, code blocks, images, tables, and Mermaid diagrams. Covers tags, buckets, and saving.
- [Spote: AI-native note-taking that remembers for you](https://docs.spote.cloud/introduction.md): Spote keeps your best AI thinking organized. Capture notes from conversations, search by meaning, and use past ideas as future context.
- [MCP server overview for Spote](https://docs.spote.cloud/mcp/overview.md): Spote has a built-in MCP server at /sse and /mcp. Connect any MCP-compatible AI agent to save, search, and retrieve your notes from within a conversation.
- [MCP prompts for guided note capture](https://docs.spote.cloud/mcp/prompts.md): Spote's three MCP prompts — capture, daily_summary, and find_related — guide your AI agent through note capture, daily review, and past-context retrieval.
- [MCP tools reference for Spote](https://docs.spote.cloud/mcp/tools.md): Full reference for all Spote MCP tools: create_note, update_note, get_note, delete_note, search_notes, find_similar, list_recent, list_buckets, and list_tags.
- [Get started with Spote in five minutes](https://docs.spote.cloud/quickstart.md): Create your Spote account, write your first markdown note with buckets and tags, and optionally connect an AI agent — all in under five minutes.