Technical reference for all 📝MythOS MCP tools. Endpoint: https://mythos.one/api/mcp. Auth: OAuth 2.0 (Claude connectors) or x-mythos-key header (Claude Code, npm package).

For natural language prompt patterns, see 📝MythOS MCP Prompts. For the full MCP reference including resources and prompts, see 📝MythOS MCP.

get_context (read-only, idempotent) — Start Here

Load the user's formatting rules, collaboration values, and personal context from their Augmentation System. Returns the full content of all four augmentation memos: Mythos Soul, Mythos Style, Mythos Human, and Mythos Memory. Must be called before create_memo or update_memo so the AI has the user's style rules in context before composing content. Any memo tagged #mythos-mcp-context with an augmentationType field is included. No parameters.

Tools (26)

search_memos (read-only, idempotent)

Search memos by query, tags, or visibility. Owner sees all visibilities including private. Default response is lean (title and tags only); pass fields to opt into more.

query — search query to match memo titles
tags — comma-separated tags to filter by
visibility — filter: public, unlisted, private (default: all for owner)
fields — comma-separated: title, snippet, tags, content, header, visibility, author
limit — max results (default 50, max 200)

read_memo (read-only, idempotent)

Read full content of a specific memo by ID. Includes notes and headerVisibility.

memoId (required) — the memo ID
section — optional section heading to extract
library — target library username (defaults to authenticated user)
Returns: content, notes (the notes section below the body), headerVisibility, tags, visibility, author

get_backlinks (read-only, idempotent)

List all memos and daily memos that @mention a given memo. Returns lean records for fast audit before renaming or deleting.

memoId (required) — the memo ID to find backlinks for
Returns: array of { id, title, type } where type is memo or daily

create_memo (write) — Requires get_context first

Create a new memo. If the user names a memo type (e.g., "reference memo", "daily log"), call read_template({ name }) directly to load its structure. If ambiguous, fall back to list_templates. If no type is given, call list_templates({ type: "memo", defaultOnly: true }) and use the default; if none, ask the user. Follow the selected template's structure.

title (required) — memo title
content — markdown content for the main body. Follows the structure of the selected template (section headings, required sections, agentNotes). Never duplicate the title as a heading in the body
notes — notes section content (displayed separately below the main body). Always populate with relevant notes and tags
tags — array of tags. Use existing tags before creating new ones
visibility — public, link, or private (default: link)
headerVisibility — object mapping lowercase header names to booleans
seoTitle — optional <title>/og:title override (max 70 chars)
seoDescription — optional meta description override (max 160 chars)

update_memo (write, idempotent) — Requires get_context first

Update content of an existing memo. Supports title-only renames without resending content. If the user asks to reshape it toward a type (e.g., "make this a reference memo"), run the template discovery protocol: read_template({ name }) or list_templates to find the template, then reshape accordingly. Otherwise, read the memo first and merge — never overwrite. For SEO-only changes, use update_memo_seo instead.

memoId (required) — memo ID to update
content (required) — new markdown content. Follow the structure of the selected template
tags — updated tags array
notes — updated notes section content
headerVisibility — updated header visibility map
seoTitle / seoDescription — optional SEO overrides (null or empty string clears)

update_memo_seo (write, idempotent)

Update only the SEO metadata of an existing memo without touching content. Does not bump contentVersion.

memoId (required) — the memo ID to update
seoTitle — new SEO title (null or empty string clears)
seoDescription — new SEO description (null or empty string clears)

delete_memo (destructive, idempotent)

Move a memo to the trash (soft delete — can be restored from trash).

memoId (required) — the memo ID to delete

list_tags (read-only, idempotent)

List all hashtags across the library with usage counts. No parameters.

chat_with_library (read-only)

Ask a question answered by 📝RAG over the knowledge base.

username (required) — library owner's username
message (required) — the question to ask
threadId — optional thread ID to continue a conversation

delta_sync (read-only, idempotent)

Get memos changed since a given timestamp.

since (required) — ISO 8601 timestamp
limit — max results

get_memo_index (read-only, idempotent)

Lightweight index of all memos — titles, tags, content hashes. No content bodies. No parameters.

list_communities (read-only, idempotent)

List public communities with names, descriptions, member counts.

limit — max results (default 50, max 100)

search_community_posts (read-only, idempotent)

Search approved posts in a community.

communitySlug (required) — community URL slug
query — search query
limit — max results (default 50, max 200)

list_tasks (read-only, idempotent)

List tasks from the MythOS task system. Aggregates standalone tasks, memo checklists, and daily memo checklists.

completed — filter by completion status (boolean)
limit — max results (default 50, max 200)
sort — due for due-date ascending order
Returns: taskId, text, completed, source, sourceId, sourceTitle, notes, dueDate, dueDateISO, dueTime, repeat, lastCompletedAt

create_task (write)

Create a new standalone task.

text (required) — task text (min 3 characters)
notes — task notes in markdown
dueDate — due date as ISO 8601 string
dueTime — due time in HH:mm format. Requires dueDate
repeat — recurrence rule object. Requires dueDate. Properties: frequency (required: daily, weekly, monthly, yearly), interval, daysOfWeek, endDate

complete_task (write, idempotent)

Mark a task as complete or incomplete. For repeating tasks: completing auto-advances the due date.

taskId (required) — universal task ID from list_tasks
completed (required) — true to complete, false to reopen

update_task (write, idempotent)

Update a task's text, notes, due date, due time, or repeat rule.

taskId (required) — universal task ID from list_tasks
text — new task text
notes — new notes in markdown
dueDate — new due date (ISO 8601) or null to clear
dueTime — due time in HH:mm format or null to clear
repeat — recurrence rule object or null to clear

read_daily_memo (read-only, idempotent)

Read a daily memo for a specific date. Returns full markdown content with Tasks checklist and Timeline entries.

date (required) — date in YYYY-MM-DD format
section — optional section heading to extract

add_daily_task (write)

Add a checklist task to the Tasks section of a daily memo. Auto-creates the daily memo if none exists.

date (required) — date in YYYY-MM-DD format
task (required) — the task text (without checkbox prefix)
afterLine — optional: insert after a line matching this text exactly

add_daily_entry (write)

Add a bullet-point entry to a section of a daily memo. Defaults to the Timeline section.

date (required) — date in YYYY-MM-DD format
entry (required) — the entry text (without bullet prefix)
section — section heading to insert into (default: Timeline)
afterLine — optional: insert after a line matching this text exactly

update_daily_memo (destructive, idempotent)

Replace the full content of a daily memo for a given date. Use this to reformat or correct prior entries; for appending new items, use add_daily_entry or add_daily_task instead. Auto-creates the memo if it doesn't exist. Restricted to the authenticated user's own library — no library parameter, and the backing endpoint rejects cross-library writes even when a library grant exists. Daily memos are private to each creator.

date (required) — date in YYYY-MM-DD format
content (required) — full markdown content to write (replaces existing content). Tags are auto-extracted; the journaled tag is applied when content reaches 200 words.

list_templates (read-only, idempotent)

List templates. Returns { id, name, description } per template — metadata only. Call read_template for full content.

type — filter: memo or daily
kind — filter: template or snippet
defaultOnly — if true, return only the default template(s)

read_template (read-only, idempotent)

Fetch a template's full body and metadata. Provide templateId, name (case-insensitive), or both (templateId wins). Name matching is tiered: exact normalized match takes precedence, then falls back to token-subset matching (e.g., name: "reference memo" matches "Reference Memo Template"). If multiple templates match, returns { ambiguous: true, matches } so the agent can present candidates to the user.

templateId — the template ID
name — template name (case-insensitive, fuzzy token-subset)

create_template (write)

Create a new template for memos or daily memos.

name (required) — template name
content (required for kind=template) — template body in markdown. Use curly brackets {like this} for placeholder instructions that agents replace when creating a memo
type — memo or daily (default: memo)
kind — template or snippet (default: template)
description — short summary of what this template is for (surfaced in list_templates for agent discovery)
agentNotes — instructions for AI agents on how to use this template
isDefault — set as default for this type+kind (unsets previous default)

update_template (write, idempotent)

Update an existing template's content, metadata, or default status.

templateId (required) — template ID
Any of: name, content, description, agentNotes, type, kind, isDefault, tags, headerVisibility, visibility

delete_template (destructive, idempotent)

Delete a template permanently.

templateId (required) — template ID

📝MythOS MCP — full MCP reference including resources, prompts, and architecture
📝MythOS MCP Prompts — natural language prompt patterns for end users
🏷️#mythos
🏷️#model-context-protocol
🏷️#api-reference