Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.spote.cloud/llms.txt

Use this file to discover all available pages before exploring further.

The Spote MCP server exposes tools your AI agent can call during a conversation. All tools require a valid Bearer token in the Authorization header. See Personal Access Tokens to create one.
Tags passed to create_note should not include the # prefix — pass ["project", "ai"] not ["#project", "#ai"]. When tags are omitted, Spote extracts them automatically from #hashtag syntax in the text.

​
Note tools

Creates a new note in Spote and indexes it immediately for semantic search. If you omit tags, Spote extracts them from any #hashtag patterns in the text.Parameters
  • title — string, required. The note title.
  • text — string, required. The note body in markdown.
  • bucket — string, optional. The folder to save the note in. Defaults to "Inbox".
  • tags — string[], optional. A list of tags without the # prefix. If omitted, Spote extracts tags from #hashtag syntax in the text.
Returns
  • Note ID
  • URL to the note in the Spote web app
  • Bucket the note was saved to
  • Tags that were applied
Example
create_note(
  title="Meeting recap: Q3 planning",
  text="Decided to prioritize the #mcp integration this sprint. Next steps: review API design.",
  bucket="Work"
)
Updates an existing note by ID. Only the fields you provide are changed — omitted fields keep their current values. Updating the text or title also rebuilds the note’s semantic embedding.Parameters
  • id — string, required. The ID of the note to update.
  • title — string, optional. New title.
  • text — string, optional. New markdown body.
  • bucket — string, optional. Move the note to a different bucket.
  • tags — string[], optional. Replace the note’s tags. Does not merge — the new list replaces the old one.
Retrieves the full content of a note by ID.Parameters
  • id — string, required. The ID of the note to retrieve.
Returns
  • Title
  • URL to the note
  • Bucket
  • Tags
  • Full markdown text
Permanently deletes a note and all of its shares. This action cannot be undone.Parameters
  • id — string, required. The ID of the note to delete.
Returns your most recently created or updated notes.Parameters
  • limit — number, optional. How many notes to return. Accepts 1–100. Defaults to 20.
  • bucket — string, optional. Filter results to a specific bucket.
ReturnsA list of notes with ID, title, bucket, and URL for each.

​
Search tools

Searches your notes using semantic similarity. Spote embeds your query and finds notes by meaning — not exact wording.Parameters
  • query — string, required. A natural-language question or topic to search for.
ReturnsUp to 10 notes ranked by semantic similarity, each with ID, title, bucket, and URL.
Finds notes that are semantically similar to a given note. Useful for surfacing related ideas and past decisions when you’re working on a specific topic.Parameters
  • note_id — string, required. The ID of the note to use as the reference.
  • limit — number, optional. How many similar notes to return. Accepts 1–20. Defaults to 5.
ReturnsA list of similar notes (excluding the reference note itself), with ID, title, and URL.

​
Organization tools

Returns all bucket names in your Spote account. Use this to see which folders exist before saving a note to a specific bucket.ParametersNone.ReturnsAll bucket names as a newline-separated list.
Returns all tags you’ve used across your notes, along with how many notes each tag appears in.ParametersNone.ReturnsAll tags with note counts, for example #project (8), one per line.
Registers a logical link between two notes. This is a preview feature — the link is recorded but graph-based navigation is not yet available in the Spote web app.Parameters
  • from_id — string, required. The ID of the source note.
  • to_id — string, required. The ID of the note to link to.