otherapi_key

Honcho

Honcho provides memory, context, and theory-of-mind infrastructure for building stateful AI agents.

Verdict

Honcho gives your team persistent memory across conversations. When you @mention it in a Project, Honcho stores conclusions about users, tracks session context, and lets AI recall past interactions without re-reading transcripts. Marketing and support teams use it to remember customer preferences; product teams use it to track feature requests across weeks of chat. Each workspace holds peers (people or entities the AI learns about), sessions (conversation threads), and messages. Reasoning modes cost tokens but surface insights automatically. Setup requires an API key from Honcho's dashboard and a workspace ID.

Common use cases

  • Remember customer pain points across support threads
  • Track feature requests mentioned in Slack over time
  • Recall user preferences without re-reading chat history
  • Surface insights from past sales conversations
  • Build context for onboarding new team members

Integration

Vendor
Honcho
Category
other
Auth
API_KEY
Tools
16
Composio slug
honcho

Tools

  • Chat With Peer

    Run usage-bearing agentic search and reasoning over a peer's learned representation to answer a question. Higher reasoning levels generally cost more and take longer. Returns one non-streaming JSON response.

  • Create Conclusions

    Store a batch of 1-100 explicit conclusions about peers, optionally tied to sessions.

  • Create Messages

    Add a batch of 1-100 attributed messages to a Honcho session. Message-level reasoning settings can trigger usage-bearing processing.

  • Delete Session
    destructive

    Permanently delete one known session and its session-scoped data. Honcho marks the session inactive immediately and completes deletion asynchronously.

  • Get Message

    Return one message by its exact ID within a session.

  • Get or Create Peer

    Return a peer by ID within a workspace, creating it with the supplied metadata and configuration when absent. Existing peers are returned unchanged.

  • Get or Create Session

    Return a session by ID, or create it with initial peers, metadata, and configuration when absent. Creation may create missing peers and start usage-bearing processing when reasoning features are enabled; existing sessions remain unchanged.

  • Get or Create Workspace

    Return a workspace by ID, or create it with metadata and configuration when absent. Enabling reasoning features during creation may start usage-bearing background processing.

  • Get Peer Representation

    Return a curated subset of conclusions representing a peer. Supplying search_query performs semantic retrieval and may consume paid search capacity; omit it for the existing default representation.

  • List Conclusions

    Return one page of stored conclusions in a workspace; use Search Conclusions for semantic retrieval.

  • List Messages

    Return one page of messages in a session; use Get Message for exact-ID retrieval.

  • List Peers

    Return one page of peers in a workspace.

  • List Sessions

    Return one page of sessions in a workspace.

  • List Workspaces

    Return one page of Honcho workspaces visible to the connected admin key.

  • Search Conclusions

    Semantically search stored conclusions in a workspace. This operation may consume paid search or embedding capacity; use List Conclusions to browse stored conclusions without semantic retrieval.

  • Search Messages

    Semantically search messages at workspace, peer, or session scope. WARNING: this operation may consume paid search or embedding capacity; use list or get message tools for exact or chronological retrieval.

Setup

Setup guide

  1. 11. Sign up at Honcho's platform and create a workspace; copy its workspace ID from the dashboard. 2. Generate an API key under your account settings and save it securely. 3. In Switchy, open your team workspace and navigate to Integrations, then click Add MCP. 4. Select Honcho from the list and paste your API key when prompted. 5. Enter your workspace ID in the configuration field so Switchy knows which Honcho workspace to query. 6. Click Connect and wait for the green confirmation banner. 7. Open any Project, type '@Honcho get or create peer' followed by a peer ID, and send; if Honcho returns peer metadata, the connection works. 8. To invoke Honcho during a conversation, @mention it with a command like 'create messages' or 'chat with peer' and supply the required session or peer ID.

What teammates see: by default, memories from Honcho are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Summarize Customer History

@Honcho chat with peer ID 'customer_42' and summarize their feature requests, complaints, and praise from all sessions. Use reasoning level 2.

Log Support Conversation

@Honcho create messages in session 'support_2025_01_15' with the last five exchanges from this thread, attributed to peer 'user_jane'.

Find Recurring Themes

@Honcho chat with peer 'beta_cohort' and identify the three most common feature requests. Use reasoning level 3 for deeper analysis.

Store Explicit Insight

@Honcho create conclusions for peer 'enterprise_lead_99': prefers async communication, budget cycle ends in Q2, interested in SSO and audit logs.

Retrieve Past Message

@Honcho get message ID 'msg_abc123' from session 'onboarding_call_jan10' and show me the exact text.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@honcho what have you learned about Sarah's communication preferences from our last 20 conversations?

Output

Based on 18 sessions with Sarah spanning 3 weeks, Honcho has identified several patterns: She prefers direct, bullet-point summaries over narrative explanations (observed in 14 of 18 sessions). She typically asks follow-up questions about implementation details rather than high-level strategy. She responds most actively to messages sent between 9-11 AM EST. Recent sessions show increased interest in automation workflows and reduced engagement with manual process discussions.

Notes

This example uses Chat With Peer at a higher reasoning level, which incurs usage-based costs and takes 3-8 seconds to process. The quality of learned representation depends on how many sessions and messages have been stored for that peer — new peers return minimal insights.

Prompt

@honcho store these three conclusions: Alex prefers async updates over meetings, Jordan needs context on legacy decisions before weighing in, and Sam wants cost implications called out explicitly.

Output

Successfully stored 3 conclusions across peers in workspace 'team-alpha'. Honcho has indexed these preferences and will surface them when you query peer behavior or ask for communication recommendations. Each conclusion is timestamped and can be updated or deleted independently. These explicit conclusions will influence future Chat With Peer responses and session-level reasoning.

Notes

Create Conclusions writes directly to Honcho's peer models without triggering immediate reasoning costs. However, once stored, these conclusions affect future usage-bearing queries. You need write permissions on the workspace, and conclusions persist until explicitly deleted.

Prompt

@honcho add the last 15 messages from this thread to a session called 'q1-planning' and summarize what we decided about the API redesign.

Output

Added 15 messages to session 'q1-planning' with 4 peer attributions (you, Sarah, Jordan, Alex). Session-level reasoning identified three decisions: (1) REST endpoints will be versioned with /v2/ prefix by Feb 15, (2) GraphQL layer deferred to Q2 pending team capacity review, (3) breaking changes require 90-day deprecation notice. Two open questions remain: authentication migration path and rate-limit policy for legacy clients.

Notes

Create Messages with reasoning enabled triggers usage-bearing processing that extracts decisions, questions, and peer stances. Processing happens asynchronously — the summary above may take 5-15 seconds to generate. Rate limits apply per workspace, so batch-adding messages from long threads can hit quota faster than expected.

Use-case deep-dives

Support team handoff continuity

When Honcho makes sense for rotating support shifts

A 6-person support team rotates coverage across three time zones. Each agent picks up tickets mid-conversation with no shared context beyond the ticket history. Honcho's peer-and-session model fits this scenario cleanly: each customer becomes a peer, each ticket thread a session, and the "Chat With Peer" tool lets the next agent query what the customer cares about without re-reading 40 Slack messages. The reasoning levels cost tokens, so you'll want to benchmark whether a medium-reasoning query is cheaper than having your agent summarize the transcript itself. If your median ticket spans fewer than three handoffs, the overhead probably isn't worth it. If handoffs are daily and your team burns 20 minutes per shift catching up, Honcho pays for itself in the first week.

Sales team account intelligence

Honcho for deal context across a 10-rep sales floor

A 10-person sales team works 200 active deals. Reps jump between accounts, and the CRM notes are stale or missing. Honcho's "Get or Create Peer" and "Create Conclusions" tools let you treat each prospect company as a peer and store explicit takeaways after every call—budget authority, pain points, competitor mentions. When a rep picks up a warm lead three weeks later, "Chat With Peer" surfaces what matters without scrolling through call transcripts. The catch: if your team already lives in Salesforce and writes decent notes, Honcho is redundant. The win is when your CRM discipline is weak and you need the AI to extract and retrieve context automatically. For teams under 5 reps or deals that close in one call, the setup cost outweighs the benefit.

Research interview synthesis

When Honcho beats manual tagging for user research

A 3-person product team runs 40 customer interviews per quarter. Each interview generates a transcript, and the team needs to answer questions like "which enterprise users mentioned SSO as a blocker?" without re-reading every file. Honcho's session-and-peer structure maps naturally: each interviewee is a peer, each interview a session, and "Create Messages" ingests the transcript with reasoning enabled. Later, "Chat With Peer" queries let you ask cross-interview questions in plain English. The trade-off is token cost—reasoning on 40 hour-long transcripts isn't free. If your interviews are short (under 15 minutes) or you only run a handful per quarter, a shared Notion doc with manual tags is faster and cheaper. Honcho wins when interview volume exceeds your team's tagging discipline and you need retrieval that understands intent, not just keywords.

Frequently asked

What does the Honcho MCP do in Switchy?

Honcho stores and reasons over conversation history across your team's AI sessions. It tracks messages, builds peer profiles, and runs agentic search to answer questions about what users have discussed or concluded. Think of it as memory infrastructure for your AI workspace — Switchy agents can query past context without re-reading every thread.

Do I need special permissions to connect Honcho?

You need a Honcho API key with write access to workspaces, peers, sessions, messages, and conclusions. Honcho uses API-key auth, so whoever connects it in Switchy controls which workspace the team writes to. If your Honcho account has usage-based reasoning enabled, connecting the MCP will trigger background processing costs on Honcho's side.

Can Honcho MCP search across all my team's chat history?

Yes, via the Chat With Peer tool. You specify a peer ID and reasoning level, and Honcho runs agentic search over that peer's learned representation. Higher reasoning levels cost more tokens and take longer. The MCP doesn't stream results — you get one JSON response per query, so it's best for targeted lookups rather than live conversation.

Why use Honcho MCP instead of storing context in Switchy directly?

Switchy's native context window resets between sessions. Honcho persists conclusions and message history indefinitely, then indexes them for semantic search. If your team needs agents to remember decisions from last week or surface patterns across dozens of conversations, Honcho's reasoning layer beats manual copy-paste. For single-session tasks, Switchy's built-in memory is simpler.

Who on the team should connect the Honcho integration?

Whoever owns your Honcho billing and workspace structure. The API key grants write access to sessions and peers, so you want one person managing which workspace Switchy writes to. Once connected, any Switchy team member can invoke Honcho tools in their prompts, but all data lands in the same Honcho workspace you configured.

More other MCPs

See all other MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.