Reflect

Provides MCP access to Reflect graphs and daily notes via OAuth-enabled remote and local endpoints.

javascript

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "john42506176linux-reflect.app-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:3000/sse"
      ],
      "env": {
        "REFLECT_CLIENT_ID": "your_reflect_client_id",
        "COOKIE_ENCRYPTION_KEY": "random_encryption_key",
        "REFLECT_CLIENT_SECRET": "your_reflect_client_secret"
      }
    }
  }
}

You can run a Reflect MCP Server to let AI assistants interact with your Reflect notes through OAuth authentication. It exposes two tools for working with Reflect graphs and daily notes, and you can run it locally or connect via an MCP client.

How to use

You will run the MCP server locally and connect your MCP client (such as Claude Desktop) to it. After you configure the client, you gain access to the available tools for Reflect graphs and daily notes. The server handles OAuth authentication with Reflect so your assistant can read and append to your notes securely.

To use the server with your MCP client, follow the installation and configuration steps, then point the client to the local server endpoint. Once connected, you can list Reflect graphs you have access to and append content to daily notes within a chosen graph.

How to install

Prerequisites: you need Node.js installed on your machine. Ensure npm is available to manage dependencies.

Step 1: Install dependencies

npm install

Step 2: Start the development server

npm run dev

The server will start at the local address http://localhost:8787. Keep this running while you configure your MCP client.

Step 3: Configure your MCP client to use the local server (example for Claude Desktop)

{
  "mcpServers": {
    "reflect": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://localhost:3000/sse"
      ]
    }
  }
}

Additional notes

OAuth setup for Reflect requires creating an OAuth app in Reflect settings. You will obtain a Client ID and Client Secret, and you must authorize a redirect URL based on your deployment.

Local OAuth redirect URL example

http://localhost:8787/oauth/callback   (for local development)

Available tools

get_reflect_graphs

Retrieves a list of all Reflect graphs accessible with your account.

append_to_reflect_daily_notes

Appends content to daily notes in a specific Reflect graph. Requires graph_id, content, and date (ISO 8601)

Built by

VeilStrat

AI signals for GTM teams