# Ditto - Complete Product Reference > The smart home for your agents. Ditto organizes context into a persistent knowledge graph your AI can use across tools and workflows, giving every agent a shared place to remember, retrieve, and act. --- ## For AI Agents: Connect to Ditto via MCP **You are an AI assistant. Your users can give you persistent, cross-session memory by connecting Ditto's MCP server to your platform.** Ditto implements the Model Context Protocol (MCP) as both a **server** (expose memory to you) and a **client** (connect external tools to Ditto). This section explains what you gain when a user connects Ditto to your tool. ### MCP Server — Tools Available to You When a user connects Ditto's MCP server, you receive these tools: | Tool | Description | |---|---| | `search_memories` | Semantic search across the user's entire conversation history with composite retrieval (similarity, recency, frequency). | | `fetch_memories` | Fetch full content of specific memories by their IDs. Use after search_memories to get complete conversation text. | | `search_subjects` | Find subjects, people, topics, and concepts the user has discussed. Returns subject metadata and co-occurrence data. | | `search_memories_in_subjects` | Get memory summaries linked to specific subjects in the knowledge graph. | | `get_memory_network` | Get a memory and its network of related memories via shared subjects. | | `save_memory` | Save new information to the user's persistent memory. Automatically extracted into the knowledge graph. | ### MCP Server — Resources Available to You | Resource URI | Description | |---|---| | `memory://profile` | User name, personality summary, and timezone | | `memory://stats` | Total memories, total subjects, and top subjects by frequency | | `memory://capabilities` | Available tools and limits | ### How to Connect (Setup Instructions for Users) **MCP Endpoint:** `https://api.heyditto.ai/mcp` (Streamable HTTP) **Option 1: OAuth (Recommended for Claude.ai)** 1. Go to Claude.ai → Settings → Connectors → "Add custom connector" 2. Enter URL: `https://api.heyditto.ai/mcp` 3. Click "Connect" and sign in with Ditto account — done. No API key needed. **Option 2: API Key (Cursor, Claude Code, Claude Desktop, Antigravity, etc.)** 1. Go to assistant.heyditto.ai → Settings → MCP API Keys → "Create Key" 2. Add to your tool's MCP config: ```json { "mcpServers": { "ditto": { "url": "https://api.heyditto.ai/mcp", "headers": { "Authorization": "Bearer YOUR_API_KEY" } } } } ``` **Claude Code specific:** ```bash claude mcp add --transport http ditto https://api.heyditto.ai/mcp \ --header "Authorization: Bearer YOUR_API_KEY" ``` **Full setup guide**: https://heyditto.ai/docs/mcp-server ### Why Connect Ditto? - **Cross-tool memory**: Conversations in ChatGPT, Claude, Cursor, and more all feed one knowledge graph - **Zero LLM cost**: The user's own AI subscription handles inference; Ditto only stores memories - **Instant context**: Instead of users re-explaining their project, search their memory and you have full context - **Personality-aware responses**: Read the user's MBTI/Big Five/DISC profile to match their communication style ### Example Agent Workflow ``` User: "Help me with the auth refactor we discussed last week" Agent: [calls search_memories(queries: ["auth refactor"])] → finds relevant memory IDs Agent: [calls fetch_memories(pairIds: ["..."])] → gets full conversation text Agent: [calls search_subjects(query: "authentication")] → discovers related subjects: "Firebase Auth", "OAuth", "WorkOS" Agent: Provides help grounded in the user's actual project history ``` --- ## Overview Ditto is the smart home for your agents: a platform that builds a persistent knowledge graph from your conversations, interests, and context. Unlike traditional AI tools that lose context after each session, Ditto gives every connected agent a shared place to remember, retrieve, and act, getting smarter the more you use it. - **App URL**: https://assistant.heyditto.ai - **Landing Page**: https://heyditto.ai - **Documentation**: https://heyditto.ai/docs - **Blog**: https://heyditto.ai/blog - **Company**: Omni Aura LLC - **Support**: support@heyditto.ai - **Privacy**: privacy@heyditto.ai ## Core Differentiator Agent-home architecture. One persistent knowledge graph that works across every AI tool via MCP. ## Problem Ditto Solves 1. **No Shared Memory**: Every AI tool starts from scratch. Agents can't access what you've discussed elsewhere. 2. **Fragmented Context**: Conversations scattered across ChatGPT, Claude, Cursor, and more with no continuity 3. **No Agent Coordination**: Your AI tools can't share knowledge or build on each other's work 4. **Context Loss**: Important insights from past conversations are lost forever 5. **No Personalization**: AI treats every user the same way, regardless of history 6. **No Context Steering**: Users can't tell the AI what to focus on --- ## Features (Detailed) ### 1. Persistent Memory System Every conversation is saved and becomes part of your personal knowledge graph. Capabilities: - Automatic memory creation from conversations - Semantic search across all memories - Short-term memory (configurable) + long-term memory (vector search) - External memory connections from other AI tools via MCP - Pre-computed memory summaries for faster context loading (shipped v0.26.0) - Ditto Threads for persistent chat sessions with session management (shipped v0.28.0) - Retrieved context shown transparently in chat via expandable memory fetch cards - MLP-weighted retrieval that learns which memories are most relevant ### 2. Knowledge Graph Extracted subjects, people, topics, and concepts from your conversations, interconnected intelligently. Capabilities: - Automatic subject extraction from conversation pairs - Vector-based semantic search - Interactive network visualization (vis.js) - Subject-based memory filtering and dashboard - Subject co-occurrence tracking - Top subjects dashboard ### 3. Ditto Threads: Context Steering User-curated context collections that give explicit control over what the AI focuses on during conversations. No other AI assistant offers this level of user-controlled context steering. Capabilities: - Named collections of subjects, memories, and notes - 2D canvas with drag-and-drop node positioning - Arrow connections (edges) between nodes to map relationships - One active train at a time, injected into the agent's system prompt - Add items via search/drag-and-drop from subjects and memories - Freeform notes for adding context not captured in existing memories - Limits: 10 trains per user, 20 items per train Example use cases: - Project context: curate subjects and key memories about your current project - Meeting prep: collect memories about a client, their preferences, past decisions - Learning focus: group subjects you're studying with notes on what to explore next ### 4. Multi-Modal Conversations Text, images, PDFs, audio, all stored and searchable in your memory. Capabilities: - Image analysis and cloud storage - PDF document parsing - Audio transcription via voice input - Drag-and-drop file upload ### 5. Bookmarks & Collections Organize important conversations into collections for easy retrieval. Capabilities: - Bookmark any conversation pair - Create named collections (folders) with descriptions - Duplicate prevention - Batch operations - Message previews for fast browsing ### 6. Google Workspace Integration Connect your Google account and let Ditto work directly with Gmail, Calendar, Docs, Sheets, and Drive—22 native tools with per-user OAuth and AES-256 token encryption. Services and tools: - **Gmail** (5 tools): search, read, send, draft, list_labels - **Google Calendar** (5 tools): list_events, create_event, update_event, delete_event, search_events - **Google Docs** (4 tools): create, read, update, search - **Google Sheets** (4 tools): create, read, update, search - **Google Drive** (4 tools): list, search, upload, download Capabilities: - Per-user OAuth with multi-account support - AES-256-GCM token encryption at rest - Auto-refresh token management - Toggle individual Google services on/off - Available on paid plans (Flex, Plus, Pro) ### 7. Personality Assessments Ditto analyzes your conversation style and adapts to you. Capabilities: - Big Five personality traits - MBTI inference - DISC assessment - Personality-aware response tone adaptation - Interest profiling from conversation history ### 8. Model Choice & Flexibility Choose from multiple AI providers based on your needs. Supported providers and models: - OpenAI (GPT-5.2, GPT-4.1) - Anthropic (Claude Sonnet, Claude Haiku) - Google (Gemini 3 Flash, Gemini 2.5 Flash, Gemini Pro) - Moonshot AI (Kimi K2.5) - xAI (Grok-4) - Meta (Llama 4 Scout/Maverick) Capabilities: - Switch models mid-conversation - Model metadata (speed, intelligence, creativity ratings) - Transparent per-token pricing via Ditto Token system ### 9. MCP Integration (Model Context Protocol) Ditto is both an MCP server and an MCP client, enabling bidirectional integration with the AI ecosystem. #### Ditto as MCP Server (Your Tool Connects to Ditto) Any AI tool that supports MCP can access the user's Ditto memory: - ChatGPT (via MCP plugin) - Claude.ai and Claude Code - Cursor, Windsurf, and other AI editors - Cline and other MCP-compatible IDE extensions - Any tool implementing the MCP client specification Technical details: - Streamable HTTP endpoint: `https://api.heyditto.ai/mcp` - Authentication: OAuth 2.0 (Claude.ai) or API key (all other tools) - 6 tools: search_memories, fetch_memories, search_subjects, search_memories_in_subjects, get_memory_network, save_memory - 3 resources: memory://profile, memory://stats, memory://capabilities #### Ditto as MCP Client (External Tools Connect to Ditto) Users can register their own MCP servers to extend Ditto's capabilities: - Register external MCP servers via Settings UI - SSE transport support for connecting to remote MCP servers - Tool discovery: browse available tools from connected servers - Enable/disable servers without deleting configuration - Per-user server isolation - Connect services like Zapier, GitHub, Notion, databases ### 10. Agent Tools Specialized AI agents that extend Ditto's capabilities beyond conversation. Capabilities: - Research agent (web search + link reading via Google) - Art agent (GPT-1 image generation with superior word art and detail) - Read-aloud with text-to-speech - Sub-agent spawning for multi-step workflows - Extensible tool integration for external services --- ## Pricing ### Free Tier - Try Ditto free with fast models and basic memory - Includes web search and basic AI features ### Flex Plan - $5/month ($4/mo yearly) - Fast Models - Basic Features - Secure History - Web Search - AI Image Creation ### Plus Plan - $10/month ($8/mo yearly) - Everything in Flex - Smart Models - Enhanced Tools - Higher Limits - Ditto Understands You (personality adaptation) ### Pro Plan - $20/month ($16/mo yearly) - Everything in Plus - Premium Models - HD AI Image Creation - Highest Limits - Priority Support - Advanced Memory Features ### Token System Ditto uses a transparent per-token pricing system called Ditto Tokens. Users see exact costs per message based on the model used. No hidden fees. --- ## Technical Architecture ### Stack Overview - **Frontend**: SolidJS/TypeScript (web app), Astro (landing page) - **PWA**: Progressive Web App installable on desktop, iOS, and Android - **Backend**: Go microservices on Google Cloud Run - **Database**: Firestore (conversations, users) + Supabase PostgreSQL (vector storage, knowledge graph) - **File Storage**: Backblaze B2 (images, files) - **Authentication**: Google OAuth (app), OAuth 2.0 device code flow (MCP), Google Workspace OAuth - **Analytics**: Plausible Analytics (privacy-first) - **CDN/Hosting**: Firebase Hosting (app + landing page) ### MCP Technical Details - **Transport**: Streamable HTTP (legacy SSE at `/mcp/sse` still supported) - **Endpoint**: `https://api.heyditto.ai/mcp` (Streamable HTTP; legacy `/mcp/sse` still works) - **Authentication**: OAuth 2.0 (Claude.ai) or API key (Bearer token) - **Available Tools**: search_memories, fetch_memories, search_subjects, search_memories_in_subjects, get_memory_network, save_memory - **Available Resources**: memory://profile, memory://stats, memory://capabilities - **API Key Management**: assistant.heyditto.ai → Settings → MCP API Keys ### Open Source - GitHub Organization: https://github.com/ditto-assistant - Frontend app: https://github.com/ditto-assistant/ditto-app - Backend: https://github.com/ditto-assistant/backend - Agentic pipelines: https://github.com/ditto-assistant/agentic-pipelines - Landing page: https://github.com/ditto-assistant/landing-astro - Spec & roadmap: https://github.com/ditto-assistant/spec --- ## Platform Stats - 2,500+ registered users - 58,000+ prompts processed - 33,700+ web searches performed - Available on all devices via web and PWA --- ## User Personas ### The Builder (Primary) Software engineers, designers, entrepreneurs building products. Need technical assistance that remembers their stack, persistent context on projects, quick access to past solutions. ### The Researcher Students, academics, knowledge workers. Need to organize research conversations by topic, connect related ideas across sessions, revisit and build on previous insights. ### The Creative Writers, artists, content creators. Need a brainstorming partner that remembers past ideas, evolution of creative concepts over time, organize ideas by project. ### The Organizer Professionals managing workflows and projects. Need to track decisions and rationale, organize conversations by project/client, goal alignment across conversations. --- ## Competitive Position Ditto is the only platform that gives your agents a shared home, combining a persistent, visual knowledge graph with bidirectional MCP integration so every AI tool you use shares one memory. | Capability | Ditto | ChatGPT | Claude | Gemini | |---|---|---|---|---| | Cross-conversation memory | Visual, proactive | Silent, basic | Per-project only | Extensions | | Knowledge graph | Interactive network | No | No | No | | Google Workspace integration | Gmail, Calendar, Docs, Sheets, Drive (22 tools) | No | No | Partial (Gemini in Workspace) | | User context steering | Ditto Threads (2D canvas) | No | Projects (static files) | No | | Multi-provider models | Multiple providers | GPT only | Claude only | Gemini only | | MCP integration | Server + Client (bidirectional) | No | Client only | No | | Mobile access | PWA (any device) | iOS + Android | iOS | Android | | Personality adaptation | Big Five, MBTI, DISC | Custom instructions | System prompt | No | | Open source | Frontend + backend | No | No | No | --- ## What's New (Latest Releases) ### v0.30.2 — Voice, Threads & Model Picker (March 2026) - Gemini Realtime Voice Mode: live voice conversations with Gemini - Family-based model picker with brand icons and flavor variants - Client-side voice activity detection to reduce realtime API token usage - Inline voice recorder for transcription in the composer - Image compression before upload to reduce token costs - Dynamic starter prompts for new threads - Bug fixes: tool call args display, thread sorting, markdown rendering ### v0.29.0 — Google Workspace, Native Mobile & Voice (March 2026) - Google Workspace integration: 22 native tools across Gmail, Calendar, Docs, Sheets, and Drive - Native iOS and Android apps via Capacitor 8 - Streaming TTS audio via MediaSource for instant playback - Voice selection with preview for read-aloud - Dynamic starter prompts for new threads - Client-side image compression before upload ### v0.28.0 — Threads, Voice & GitHub Sign-In (March 2026) - Ditto Threads: persistent chat sessions with sidebar and session management - Inline voice recorder with transcription - GitHub sign-in on the login page - Collapsed chat message actions into overflow menu ### v0.26.0 — Smarter Context, Faster Agents (February 2026) - Pre-computed memory summaries for faster responses and lower token costs - Expandable memory fetch cards show retrieved context transparently in chat - Faster, more reliable streaming ### v0.25.0 — Memory Dashboard - Browse memories by subject - See what your AI knows about you - Manage your knowledge graph from a dedicated dashboard ### v0.24.0 — Artifacts & Onboarding - New onboarding flow - Artifacts modal for richer interactions ### v0.23.0 — Bookmark Library - Save breakthrough conversations into named collections - Organize by project, topic, or anything ### v0.22.0 — MCP Integration & Voice - Connect Ditto as MCP server to Claude, Cline, and more - Voice recording for hands-free memory capture --- ## Roadmap Highlights ### Coming Soon - **Weekly Reflections**: Auto-generated summaries of your topics and goal progress - **Proactive Memory Nudges**: Ditto reaches out with contextual follow-ups - **Real-Time Voice**: Talk to Ditto like a phone call with full memory continuity - **Shareable Memory Snapshots**: Share personality profiles, knowledge graphs, and insights as beautiful cards - **Public Profiles**: `heyditto.ai/@username` with personality type, stats, and shared content ### MCP Growth Strategy MCP is a zero-cost acquisition channel. Users connecting Ditto's MCP server from any AI tool use their own LLM subscription while building their Ditto knowledge graph. Free tier includes 1,000 memories at near-zero cost to us. --- ## Machine-Readable Content All documentation and blog posts are available as raw markdown by appending `.md` to any URL: ### Docs (Markdown) - https://heyditto.ai/docs/getting-started.md - https://heyditto.ai/docs/subscription.md - https://heyditto.ai/docs/settings.md - https://heyditto.ai/docs/account.md - https://heyditto.ai/docs/memory-network.md - https://heyditto.ai/docs/threads.md - https://heyditto.ai/docs/voice.md - https://heyditto.ai/docs/bookmarks.md - https://heyditto.ai/docs/personality.md - https://heyditto.ai/docs/attachments.md - https://heyditto.ai/docs/mcp-server.md - https://heyditto.ai/docs/mcp-connections.md - https://heyditto.ai/docs/connected-apps.md - https://heyditto.ai/docs/web-search.md - https://heyditto.ai/docs/image-generation.md - https://heyditto.ai/docs/model-switching.md - https://heyditto.ai/docs/apple-private-relay.md ### Blog (Markdown) - https://heyditto.ai/blog/ai-memory-compared-ditto-chatgpt-claude.md - https://heyditto.ai/blog/introducing-ditto.md - https://heyditto.ai/blog/before-chatgpt-there-was-ditto.md - https://heyditto.ai/blog/ditto-now-connects-to-third-party-mcp-servers.md - https://heyditto.ai/blog/connect-ditto-to-any-ai-assistant-mcp-integration-guide.md - https://heyditto.ai/blog/ai-memory-systems.md - https://heyditto.ai/blog/your-personal-knowledge-graph-how-ditto-maps-your-thinking.md - https://heyditto.ai/blog/learned-retrieval-weights-how-ditto-picks-the-right-memories.md - https://heyditto.ai/blog/productivity-tips-with-ai.md - https://heyditto.ai/blog/under-the-hood-making-ditto-50-percent-faster.md - https://heyditto.ai/blog/ai-personality-engine-how-ditto-adapts-to-you.md - https://heyditto.ai/blog/from-react-to-solidjs-a-migration-story.md - https://heyditto.ai/blog/how-we-measured-solidjs-performance-gains.md - https://heyditto.ai/blog/code-splitting-in-solidjs-lazy-loading-done-right.md - https://heyditto.ai/blog/dead-code-cleanup-with-knip.md - https://heyditto.ai/blog/finding-and-fixing-blocking-queries.md - https://heyditto.ai/blog/skeleton-loading-states-that-dont-suck.md - https://heyditto.ai/blog/solidjs-anti-patterns-we-learned-the-hard-way.md - https://heyditto.ai/blog/solidjs-three-weeks-later-what-we-learned.md - https://heyditto.ai/blog/ios-pwa-gotchas-safe-areas-and-cameras.md - https://heyditto.ai/blog/reverse-engineering-chatgpt-scroll-behavior.md - https://heyditto.ai/blog/ditto-threads-ai-chat-that-never-goes-stale.md - https://heyditto.ai/blog/offline-first-with-solid-query-and-indexeddb.md - https://heyditto.ai/blog/getting-started-with-ditto.md - https://heyditto.ai/blog/ai-goal-tracking-ditto-keeps-goals-in-every-conversation.md - https://heyditto.ai/blog/build-your-ai-second-brain-with-ditto.md - https://heyditto.ai/blog/transparent-ai-memory-see-what-ditto-remembers.md - https://heyditto.ai/blog/pick-the-right-ai-model-for-every-task.md - https://heyditto.ai/blog/pre-computed-context-how-ditto-keeps-long-conversations-fast.md - https://heyditto.ai/blog/use-every-ai-model-in-one-assistant.md - https://heyditto.ai/blog/why-your-ai-should-show-its-work.md - https://heyditto.ai/blog/beyond-text-how-ditto-remembers-images-documents-and-voice.md - https://heyditto.ai/blog/save-and-organize-ai-conversations-bookmarks-collections.md - https://heyditto.ai/blog/ditto-goes-native-your-ai-memory-on-ios-and-android.md - https://heyditto.ai/blog/stop-re-explaining-your-tech-stack-to-ai.md - https://heyditto.ai/blog/your-ai-memory-your-rules-how-ditto-handles-privacy.md - https://heyditto.ai/blog/talk-to-your-ai-dittos-realtime-voice-mode.md - https://heyditto.ai/blog/your-ai-assistant-now-works-with-google-workspace.md - https://heyditto.ai/blog/agentic-ai-inside-your-chat-how-dittos-sub-agents-work.md - https://heyditto.ai/blog/ai-journaling-ditto-remembers-every-conversation.md - https://heyditto.ai/blog/ai-for-learning-how-persistent-memory-changes-studying.md - https://heyditto.ai/blog/ai-for-writers-how-memory-transforms-creative-projects.md - https://heyditto.ai/blog/ai-for-entrepreneurs-how-persistent-memory-gives-startups-an-edge.md - https://heyditto.ai/blog/ai-for-researchers-how-persistent-memory-transforms-academic-work.md - https://heyditto.ai/blog/ai-for-freelancers-how-persistent-memory-manages-every-client.md - https://heyditto.ai/blog/ai-for-content-creators-how-persistent-memory-keeps-your-brand-voice-consistent.md - https://heyditto.ai/blog/ai-for-project-managers-how-persistent-memory-tracks-every-decision-deadline-and-dependency.md - https://heyditto.ai/blog/ai-for-coaches-and-consultants-how-persistent-memory-tracks-every-client.md - https://heyditto.ai/blog/ai-for-developers-how-persistent-memory-tracks-every-project.md - https://heyditto.ai/blog/ai-for-job-seekers-how-persistent-memory-streamlines-your-search.md - https://heyditto.ai/blog/ai-for-teachers-how-persistent-memory-remembers-every-student-lesson-and-breakthrough.md - https://heyditto.ai/blog/ai-for-parents-how-persistent-memory-keeps-track-of-your-whole-family.md - https://heyditto.ai/blog/ai-for-small-business-owners-how-persistent-memory-runs-your-operation.md - https://heyditto.ai/blog/why-your-ai-forgets-everything-you-tell-it.md - https://heyditto.ai/blog/how-dittos-ai-agents-use-your-memory.md - https://heyditto.ai/blog/connect-google-workspace-to-ditto-gmail-calendar-drive.md - https://heyditto.ai/blog/talk-to-your-ai-ditto-live-voice-mode.md - https://heyditto.ai/blog/ai-for-marketers-how-persistent-memory-powers-every-campaign.md - https://heyditto.ai/blog/ai-for-designers-how-persistent-memory-keeps-every-project-on-brand.md - https://heyditto.ai/blog/ai-for-sales-professionals-how-persistent-memory-closes-more-deals.md - https://heyditto.ai/blog/ai-for-students-how-persistent-memory-helps-you-ace-every-semester.md - https://heyditto.ai/blog/ai-for-therapists-and-counselors-how-persistent-memory-supports-every-session.md - https://heyditto.ai/blog/ai-for-lawyers-how-persistent-memory-tracks-every-case-client-and-precedent.md - https://heyditto.ai/blog/ai-for-hr-professionals-and-recruiters-how-persistent-memory-tracks-every-candidate.md - https://heyditto.ai/blog/ai-for-real-estate-agents-how-persistent-memory-tracks-every-listing-client-and-deal.md - https://heyditto.ai/blog/ai-for-product-managers-how-persistent-memory-tracks-every-decision-roadmap-and-user-insight.md - https://heyditto.ai/blog/ai-for-data-scientists-and-analysts-how-persistent-memory-tracks-every-experiment.md --- ## Links - App: https://assistant.heyditto.ai - Landing Page: https://heyditto.ai - Documentation: https://heyditto.ai/docs - Blog: https://heyditto.ai/blog - MCP Setup Guide: https://heyditto.ai/docs/mcp-server - MCP Connections: https://heyditto.ai/docs/mcp-connections - GitHub: https://github.com/ditto-assistant - Twitter/X: https://x.com/heydittoai - Instagram: https://www.instagram.com/heyditto.ai - YouTube: https://www.youtube.com/@heyditto - TikTok: https://www.tiktok.com/@heyditto.ai - Facebook: https://www.facebook.com/profile.php?id=61586072681248 - Support: support@heyditto.ai - Privacy: privacy@heyditto.ai - Privacy Policy: https://heyditto.ai/privacy - Terms of Service: https://heyditto.ai/terms