> ## 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={"system"}
{
  "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={"system"}
# 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 scheduled task fails to write

1. Verify vault path in scheduled task 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={"system"}
{
  "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).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.