> ## Documentation Index > Fetch the complete documentation index at: https://docs.joinruna.com/llms.txt > Use this file to discover all available pages before exploring further. # Use Runa in Muse > Connect Runa to Muse and ask about your meetings, transcripts, action items, and the people you meet with. Runa connects to Muse as a read-only connector. Once it's connected, Muse can search your meetings, open a meeting's summary, key takeaways, action items, and full transcript, look up the people and companies you meet with, and see your upcoming meetings. The connector's server address is: ``` https://mcp.joinruna.com/mcp ``` ## Connect in Muse 1. In Muse, open **Settings → Connectors**. 2. Select **Connect** next to Runa, then **Continue**. 3. Sign in to Runa with Google or Microsoft. You can also ask Muse to "connect my Runa account." New to Runa? Signing in with Google or Microsoft when you connect creates your account. Meetings come from the Runa desktop app, so a new account has nothing to search until you record your first meeting. ## What you can ask * "What was my most recent meeting, and what do I need to do next?" * "Where did we discuss pricing with Acme, and what did we decide?" * "What did Dana commit to in our last call?" * "Prep me for my next meeting: who's attending and what did we last discuss?" * "List my open action items from the last two weeks." ## What the connector can read * **Meetings**: titles, dates, participants, summaries, key takeaways, action items, and full transcripts. * **Search**: your meetings, notes, and the documents in your folders. * **People and companies**: what Runa remembers about the people and companies you meet with. * **Upcoming meetings**: the next week, read live from the Google and Outlook calendars you connected to Runa, with the desktop app's last sync covering the rest. * **Apps you connected to Runa**: live, read-only data from HubSpot, Salesforce, Gmail, Outlook, Google Drive, Slack, Linear, Notion, and Basecamp. Results are limited to what you can already open in Runa and to your organization's policy for AI assistants. Audio recordings and voice profiles are never shared. ## Tools Every tool is a read. None creates, changes, sends, or deletes anything, so none is a write or a sensitive write, and none has side effects. Each one declares `readOnlyHint: true` and `destructiveHint: false`. Each tool returns JSON, as text and as `structuredContent`: the items it found, each with a `runa://` id or a link back to its source, and a cursor when there are more pages. Required inputs are in bold. | Tool | Reads | Inputs | | - | - | - | | `search` | Meeting summaries, notes, and folder documents, ranked by relevance | **query** | | `fetch` | One item in full: a meeting's summary, takeaways, action items, and transcript, or a document's text | **id** | | `meetings_get_last` | Your most recent recorded meeting | before | | `meetings_list` | Your recorded meetings by date, newest first | limit, date\_start, date\_end, timezone, cursor | | `meetings_upcoming` | Your upcoming calendar meetings, soonest first | limit | | `meetings_get_last_matching` | Your most recent meeting on a topic or with a person | topic\_query, participant\_query, date\_start, date\_end, timezone, minimum\_relevance\_score | | `meetings_find_quotes` | The exact transcript lines in one meeting where something was said | **resource\_uri**, **query**, limit | | `runa_list_action_items` | Action items from your meetings, open ones by default | status, owner, date\_start, date\_end, timezone, limit | | `runa_query_organizational_memory` | Decisions, commitments, blockers, and changes, each with its source | **question**, intent, entity, date\_start, date\_end, current\_only, state\_filter, limit | | `runa_find_experts` | Colleagues with evidence of working on a topic | **query**, limit, include\_me, date\_start, date\_end | | `runa_lookup_person` | What Runa knows about a person, and your recent meetings with them | **query**, include\_facts, include\_meetings | | `runa_get_company_memory` | Notes, facts, and meeting history for a company | **domain** | | `runa_search_knowledge` | Search with filters for result count, source type, and dates | **query**, limit, source\_types, date\_start, date\_end | | `runa_search_everything` | One search across Runa and every app you connected to it | **query**, sources, date\_start, date\_end, limit\_per\_source, cursor | | `runa_fetch_resource_page` | The next page of a long transcript or document, or one record from a connected app | **resource\_uri**, **part**, cursor, max\_chars | | `runa_gmail_search` | Recent Gmail messages between you and one person | **person**, keywords | | `runa_gmail_read_inbox` | Your Gmail inbox, 1 to 30 days back | days, unanswered, keywords, page\_size, cursor | | `runa_outlook_search` | Recent Outlook messages between you and one person | **person**, keywords | | `runa_outlook_read_inbox` | Your Outlook inbox, 1 to 30 days back | days, unanswered, keywords, page\_size, cursor | | `runa_hubspot_search` | HubSpot contacts, companies, deals, tickets, or custom objects | **object**, query, filters, filterGroups, sorts, properties, limit, after | | `runa_salesforce_query` | One read-only SOQL `SELECT` | **soql** | | `runa_slack_list_channels` | The Slack channels Runa was added to | None | | `runa_slack_read_channel` | Recent messages in one of those channels | **channel** | | `runa_google_drive_search` | The Google Drive files you shared with Runa | query, name, mime\_types, modified\_after, modified\_before, owner\_email, account\_id, limit, cursor | | `runa_notion_search` | The Notion pages and databases you shared with Runa | query, kind, workspace, limit | | `runa_linear_list_issues` | Linear issues by assignee, team, project, cycle, status, or label | workspace, team, project, cycle, assignee, status, label, limit | | `runa_linear_search_issues` | Linear issues matching a full-text search | **query**, workspace, team, project, cycle, assignee, status, label, limit | | `runa_basecamp_search` | Basecamp messages, to-dos, and documents | **query**, project, account | | `runa_basecamp_my_assignments` | Your open Basecamp assignments | due, account | ## Sign-in and permissions Runa uses OAuth 2.1 with PKCE, and supports Dynamic Client Registration and Client ID Metadata Documents. Muse asks for all ten of Runa's scopes, and every one of them is read-only: | Scope | Lets Muse read | | - | - | | `runa.search` | Search results, including organizational memory | | `runa.meetings.read` | Meetings and their summaries | | `runa.transcripts.read` | Full transcripts and exact quotes | | `runa.calendar.read` | Upcoming meetings | | `runa.documents.read` | Documents in your folders | | `runa.actions.read` | Action items | | `runa.people.read` | The people you meet with | | `runa.company_memory.read` | The companies you meet with | | `runa.experts.read` | Colleagues who know a topic | | `runa.connectors.read` | Apps you connected to Runa | `fetch` and `runa_fetch_resource_page` need the scope for the kind of item they open. Access is checked again on every call, so disconnecting takes effect on the next one. ## Errors and limits * **App not connected**: a connected-app tool returns a note saying how to connect the app in Runa, instead of data. * **Long results**: a long transcript or document comes back in pages, and the result says how to read the rest. * **Organization policy**: if your workspace admin turned off AI assistants or a kind of data, the result says so. * **Disconnected**: once you disconnect, the next call returns an error saying the connection is no longer valid. Connect Runa again to continue. * **Rate limits**: each connection has an hourly usage budget, and each app you connected to Runa has an hourly call limit per user. A call over either one returns an error saying how long to wait, and calls work again at the top of the hour. Errors come back as tool results with `isError: true` and a plain-language message. ## Disconnect In Runa, open **Settings → Connectors → AI assistants** and switch off Muse. The connection stops working on its next request. You can also disconnect Runa in Muse under **Settings → Connectors**. ## Get help Email [admin@joinruna.com](mailto:admin@joinruna.com). This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.