> ## Documentation Index
> Fetch the complete documentation index at: https://docs.screenpipe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# obsidian - sync screen history to your notes

> Sync screenpipe's screen history and meeting transcripts into Obsidian via the Copilot plugin so you can query your activity from your local notes vault.

[Obsidian](https://obsidian.md) 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](https://github.com/logancyang/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:

```json theme={null}
{
  "screenpipe": {
    "command": "npx",
    "args": ["-y", "screenpipe-mcp"]
  }
}
```

4. 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:

```bash theme={null}
# 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:

```json theme={null}
{
  "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).