Integrations

Integrations are off until you configure them. Strandweave keeps its local library as the source of truth and shows when an integration may send data to another service. Recording never starts automatically.

Capture meeting or system audio

Strandweave can record from your Mac's built-in microphone or any other input macOS exposes. That is a straightforward option for in-person and speakerphone calls, where you want to capture the sound in the room.

macOS does not offer another app's output as a normal microphone input. For a clean, direct recording of a call or other system audio playing on your Mac, install a trusted virtual audio device such as BlackHole, then route the sound through it.

  1. Install BlackHole 2ch or another macOS virtual audio device.
  2. Open Audio MIDI Setup on your Mac.
  3. Create a Multi-Output Device containing your speakers or headphones and the virtual device.
  4. Select that Multi-Output Device as the Mac's sound output.
  5. In Strandweave, open Settings → Recording and select the virtual device as the preferred input.
  6. Make a short test recording and confirm both playback and transcript quality before the meeting.

When you finish, restore your normal speakers or headphones as the Mac's output and your microphone as Strandweave's input. A virtual device captures the routed system sound; it does not by itself mix in your microphone. Make a short test recording before an important meeting, whichever setup you use.

Always follow the recording rules that apply to your location and meeting. Record consent in the session rather than assuming it was given.

Link Apple Calendar and use meeting reminders

  1. Open Settings → Calendar Sync.
  2. Choose Request Calendar Access for Apple Calendar.
  3. Approve the macOS calendar permission.
  4. Open a session's Meeting Details tab.
  5. Choose Link to Calendar Event and select an upcoming event.

Strandweave copies the event title, participants, location and scheduled time into the session. It reads calendar information locally and does not modify the original event. Use Refresh from Calendar to copy later changes or Unlink from Calendar to remove the connection while keeping the copied meeting details.

Turn on Prompt to record calendar meetings to receive an optional notification before a linked meeting. You choose the reminder time. Only the notification's explicit Start Recording action starts recording; dismissing it does nothing.

Get an opt-in Zoom or Webex prompt

Meeting-app detection is separate from calendar reminders and currently recognises Zoom and Webex meeting windows.

  1. Open Settings → Calendar Sync.
  2. Turn on Prompt to record Zoom / Webex meetings.
  3. Grant Accessibility permission when macOS asks.
  4. Join the meeting normally and use Start Recording if the notification appears.

Detection checks locally for a matching meeting window. It does not read call content, chat or participant names. Accessibility permission is broad at the macOS level, but Strandweave uses it here only to identify supported meeting windows. Detection is off by default and never starts a recording without your action.

Configure an AI provider

Open Settings → AI Providers and choose one of these routes:

  • Claude - add your Anthropic API key and select a supported model.
  • OpenAI - add your OpenAI API key and select or enter a supported model.
  • Local inference - use Strandweave's guided Ollama setup or connect an OpenAI-compatible local endpoint.

API keys are stored in macOS Keychain. With Claude or OpenAI, eligible transcript text, meeting notes and meeting metadata may be sent to the provider when you request a summary or extraction. Audio, voice profiles and local files are not sent. Local inference keeps processing on your Mac or on the local endpoint you configure.

Controls under Settings → Summarisation can remove participant names and block cloud requests when consent is missing or when a session is not eligible for intelligence processing. Sessions marked Exclude from AI exports are always blocked from cloud AI.

Connect an Obsidian vault

  1. Open Settings → Obsidian Vault.
  2. Choose the local folder that contains your vault.
  3. Select a Filing Mode: Off, Inbox, Suggest or Auto-file.
  4. Approve a summary, then export it from the session or Second Brain screen.

Inbox places notes in Strandweave's inbox structure. Suggest proposes a destination for you to confirm. Auto-file uses confidence checks and falls back to the inbox when a safe match is unavailable. Strandweave does not write inside the vault's .obsidian folder.

You can optionally install the Second Brain starter structure and enable automatic vault sync after summary approval. Transcript and recording copies are separate options and remain off until you choose them. Conflict prompts protect edits made outside Strandweave.

Connect Claude, Codex or another local agent

Local MCP access lets a compatible agent read approved, governed meeting context through the helper bundled with Strandweave. It is Local Pro, local-only and off by default.

  1. Open Settings → MCP / Local Agent Access.
  2. Turn on Enable local MCP access.
  3. Choose Safe default, Project context or Full local power user.
  4. Under Set up local agents, configure Claude Desktop, Claude Code or Codex.
  5. Restart the agent, then test it with a request for recent approved sessions.

Re-running the in-app setup replaces only Strandweave's own server entry in that agent's configuration. It does not enable access by itself and does not replace the rest of the agent's settings.

Manual helper path

If you prefer to configure an agent yourself, point it to the helper inside the installed app:

/Applications/Strandweave.app/Contents/MacOS/strandweave-mcp

Claude Desktop

Add a strandweave entry under mcpServers in ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "strandweave": {
      "command": "/Applications/Strandweave.app/Contents/MacOS/strandweave-mcp",
      "args": []
    }
  }
}

Claude Code

claude mcp add strandweave -- /Applications/Strandweave.app/Contents/MacOS/strandweave-mcp

Codex

Add this table to ~/.codex/config.toml:

[mcp_servers.strandweave]
command = "/Applications/Strandweave.app/Contents/MacOS/strandweave-mcp"
args = []

If Strandweave is installed elsewhere, use the matching path inside that copy of the app. Restart the agent after changing its configuration.

What an agent can receive

  • Safe default exposes approved summaries and minimal session metadata.
  • Project context adds approved notes and annotations where permitted.
  • Full local power user can add bounded transcript excerpts where permitted, never the full raw transcript.

Excluded sessions, declined-consent content, unapproved meeting content, raw audio, voice profiles, speaker embeddings and API keys are never available. Agents cannot approve, edit or delete sessions; trigger exports; send email; schedule events; publish content; run automation; or call your AI providers.

Good test prompts include "List my recent approved sessions", "What open actions were recorded last week?" and "Draft a project update from approved context". Treat the result as a proposal and review it before sharing or acting on it.