# Reflect MCP

> Reflect lets your AI agent read, write, and explore your private knowledge graph directly through conversation. It turns your notes app into an active research assistant that maps connections between ideas, bookmarks, books, and daily thoughts.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** networked-thought, backlinks, knowledge-graph, personal-wiki, thought-capture, daily-journaling

## Description

You connect your Reflect account to your AI client to give it access to your personal, networked thought graph. This MCP lets you treat your entire collection of notes not as separate files, but as one interconnected web of knowledge.

Instead of manually searching through dozens of folders or apps, you simply ask your agent questions about your ideas. It can look up specific notes, find every piece of content that links back to a core concept, and map out the relationships between disparate thoughts. You can also tell it to capture action items from a call and log them directly into today’s daily note, or save a URL you just read so it gets indexed with metadata.

This integration means your AI agent becomes a personal knowledge broker that understands your context—the connections between your research, your reading list, and your brainstorming sessions. When you pair this MCP with the Vinkius catalog of tools, you build an assistant capable of synthesizing complex ideas without ever needing to leave your chat window.

## Tools

### append_daily_note
Adds formatted text content directly into today's date entry in your journal.

### create_link
Saves a new web link or bookmark to one of your defined knowledge graphs, automatically pulling metadata.

### create_note
Generates an entirely new note within a graph, allowing you to specify the subject and content upfront.

### get_backlinks
Retrieves a list of all other notes that contain links pointing back to a specific piece of content.

### get_current_user
Fetches basic profile details for the Reflect user who is logged into your AI client.

### get_note
Pulls up the full text and metadata for a specific, existing note in your graph.

### list_books
Displays all books you have saved or imported into the Reflect system.

### list_graphs
Shows a list of every separate workspace or 'graph' you currently use in Reflect Notes.

### list_links
Lists all the web bookmarks you have saved within a specific knowledge graph.

### list_notes
Generates a list of every note contained within one designated Reflect graph.

## Prompt Examples

**Prompt:** 
```
List all available graphs in my Reflect account.
```

**Response:** 
```
Using `list_graphs`, I found 2 distinct workspaces: "Personal Brain" (ID: 6f...2c) and "Project Insights" (ID: 9a...11).
```

**Prompt:** 
```
Create a permanent note titled 'Meeting 2024 Strategy' inside my 'Personal Brain' graph with summary bullet points.
```

**Response:** 
```
Executing `create_note` on Graph ID '6f...2c'. I have successfully created 'Meeting 2024 Strategy' and piped the Markdown list of bullets into it.
```

**Prompt:** 
```
Find notes linked by backlinks that point to my note 'React Learnings'.
```

**Response:** 
```
I called `list_notes` to verify 'React Learnings', acquiring its note_id 'xx82', then ran `get_backlinks`. You have 3 other notes connecting to it: 'Frontend Architecture', 'Day 2 Journal', and 'Tech Stack Overview'.
```

## Capabilities

### List all available knowledge workspaces
The agent can show you every separate area or 'graph' where you keep notes.

### Retrieve and manage specific notes
You can ask the agent to pull up a note by title, list all notes in a workspace, or retrieve the full content of a single document.

### Build new permanent knowledge entries
The agent can create brand-new, structured notes and save them into your graph instantly.

### Log daily thoughts and summaries
You can append conversation summaries or quick ideas directly to today's date entry without creating a new note.

### Map related concepts
The agent finds all other notes that point back to a specific topic, revealing connections you might have forgotten about.

### Capture and organize links and books
It saves web bookmarks or imports highlights from your reading list so they are searchable alongside your text notes.

## Use Cases

### Synthesizing research for a grant proposal
A researcher has compiled notes on five different theories. They ask their agent to run `list_notes` across the project graph, then use `get_backlinks` on 'Quantum Computing' to pull together every piece of evidence related to that topic, creating a comprehensive draft outline.

### Archiving client meeting takeaways
A consultant finishes a video call. Instead of copying bullet points into an email, they tell their agent to summarize the discussion and use `append_daily_note` in the main project graph. This permanently logs the decisions with context.

### Reviewing old work for inspiration
A writer is starting a new book chapter. They ask their agent to list all notes related to 'Victorian London' using `list_notes`. The AI then pulls up key details from an archived note with `get_note`, providing immediate context.

### Building a project roadmap
A founder needs to track external inspiration. They use the agent to save crucial industry articles via `create_link` and then ask for a summary of all saved links related to 'AI Ethics', ensuring they capture ideas from multiple sources.

## Benefits

- Deep context retrieval: Instead of manually searching through dozens of files, just ask the agent to use `get_backlinks` and instantly see every note that referenced a key idea. It finds connections you might have forgotten about.
- Structured logging: When you finish a call or meeting, tell your AI client to summarize it and log those decisions using `append_daily_note`. This keeps your main journal clean while ensuring no action item is lost.
- Idea capture on the fly: Stop wasting time switching apps. You can ask the agent to create permanent notes with `create_note` or save a URL with `create_link`, keeping your brainstorming session uninterrupted.
- Full knowledge visibility: Get an overview of all your work by first running `list_graphs`. This helps you understand which major workspaces contain related projects and ideas, making your entire system visible to the AI.
- Reference material access: Your agent can handle external context. It shows you everything in `list_books` or pulls up a specific document using `get_note`, treating all your sources as equally accessible.

## How It Works

The bottom line is that you tell the AI what to find or write using plain English, and it handles the complex data retrieval from your private graph.

1. First, you authorize the Reflect MCP plugin within your active AI client extension.
2. Next, you secure your personal OAuth Access Token from your Reflect developer settings and embed it into the integration setup.
3. After connecting, you chat naturally with your agent, prompting tasks like, 'Find all notes connected to 'AI Strategy'.' or 'Summarize this meeting and log it to my daily note.'

## Frequently Asked Questions

**How does Reflect MCP help me find connections between my notes?**
It uses the `get_backlinks` tool to scan your entire graph and list every single note that points back to a specific concept. This reveals context you might have otherwise missed.

**Can Reflect MCP write new content for me?**
Yes, it can create entirely new notes using `create_note` or append structured updates to your journal via `append_daily_note`. You just give the agent the material and tell it where to put it.

**Do I need a specific client app to use Reflect MCP?**
No, as long as your AI client supports the Model Context Protocol (MCP) standard, you can connect this integration. This means compatibility across most modern agents and coding environments.

**What is the difference between `list_notes` and `get_note` in Reflect MCP?**
`list_notes` gives you a directory of every note in a graph, showing titles. `get_note` pulls up the actual content and metadata for one specific note when you know its title or ID.

**How do I save external information using Reflect MCP?**
You use the `create_link` tool to bookmark URLs. The agent handles extracting relevant metadata automatically, so your bookmarks are searchable alongside everything else in your graph.