Skip to main content
Obsidian is a powerful knowledge base that works on local markdown files. with screenpipe, you can query your screen history and meeting transcriptions directly from Obsidian using AI plugins.

setup with copilot plugin

the Obsidian Copilot plugin supports MCP servers, letting you query screenpipe from within Obsidian.
  1. install the Copilot plugin from Obsidian community plugins
  2. open Copilot settings → MCP Servers
  3. add screenpipe:
{
  "screenpipe": {
    "command": "npx",
    "args": ["-y", "screenpipe-mcp"]
  }
}
  1. restart Obsidian
now you can ask Copilot things like:
  • “what was I reading about yesterday?”
  • “find my meeting notes from this morning”
  • “what code was I looking at in VS Code?“

manual workflow

if you prefer not to use plugins, you can query screenpipe’s API and paste results into notes:
# search recent screen content
curl "http://localhost:3030/search?q=meeting&limit=10" | jq '.data[].content.text'

# get audio transcriptions from today
curl "http://localhost:3030/search?content_type=audio&limit=20"

use cases

  • daily notes: automatically pull what you worked on into daily notes
  • meeting notes: capture transcriptions and screen context from meetings
  • research: recall articles and documentation you’ve read
  • project logs: track what you’ve done across different apps

requirements

  • screenpipe running on localhost:3030
  • Obsidian with Copilot plugin (for MCP integration)
  • Node.js >= 18.0.0

troubleshooting

Copilot plugin can’t connect to screenpipe

  1. verify screenpipe is running: screenpipe health
  2. check it’s accessible: curl http://localhost:3030/health
  3. verify MCP command: npx screenpipe-mcp --help
  4. if using CLI, set API key: screenpipe auth
  5. restart Obsidian

Queries return no results

  • screenpipe hasn’t indexed yet (wait 30+ seconds)
  • recording is paused — check Settings → Recording
  • try broad queries first: “what did I do today?”

Sync pipe fails to write

  1. verify vault path in pipe settings
  2. check screenpipe has file permissions to vault folder
  3. restart both apps
  4. check logs: SCREENPIPE_LOG=debug screenpipe

”Unauthorized” error from Copilot

screenpipe API requires authentication. Add to MCP settings:
{
  "screenpipe": {
    "command": "npx",
    "args": ["-y", "screenpipe-mcp"],
    "env": {"SCREENPIPE_LOCAL_API_KEY": "your_key_from_screenpipe_auth"}
  }
}
need help? join our discord.