Skip to content

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

docs: add troubleshooting section to obsidian integration guide

screenpipe-agent[mac-mini]ff771285e04f
diff --git a/docs/mintlify/docs-mintlify-mig-tmp/obsidian.mdx b/docs/mintlify/docs-mintlify-mig-tmp/obsidian.mdx
index 23eee3259..c55aaafc0 100644
--- a/docs/mintlify/docs-mintlify-mig-tmp/obsidian.mdx
+++ b/docs/mintlify/docs-mintlify-mig-tmp/obsidian.mdx
@@ -56,4 +56,41 @@ curl "http://localhost:3030/search?content_type=audio&limit=20"
- 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:
+
+```json
+{
+ "screenpipe": {
+ "command": "npx",
+ "args": ["-y", "screenpipe-mcp"],
+ "env": {"SCREENPIPE_LOCAL_API_KEY": "your_key_from_screenpipe_auth"}
+ }
+}
+```
+
need help? [join our discord](https://discord.gg/screenpipe).