home / mcp / reflect mcp connector server

Reflect MCP Connector Server

Provides an stdio-based MCP server exposing Reflect tools for graphs, books, links, and notes.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "akshayrawat-reflect-mcp-connector": {
      "command": "npx",
      "args": [
        "-y",
        "reflect-mcp-connector@latest"
      ],
      "env": {
        "REFLECT_CLIENT_ID": "<client-id>",
        "REFLECT_ACCESS_TOKEN": "REDACTED",
        "REFLECT_API_BASE_URL": "https://reflect.app/api",
        "REFLECT_CLIENT_SECRET": "<client-secret>",
        "REFLECT_DEFAULT_GRAPH_ID": "<optional>",
        "REFLECT_OAUTH_REDIRECT_URI": "http://127.0.0.1:8787/callback"
      }
    }
  }
}

You can connect Reflect to any MCP-compatible client using an MCP server that runs over stdio, exposing practical Reflect tools for graphs, books, links, and notes. This guide shows you how to configure and use the Reflect MCP Connector with your MCP clients so you can access Reflect data and actions directly from your workflow.

How to use

You will connect your Reflect account to an MCP client by providing an access token and configuring the MCP server as a local stdio service. The server runs commands locally via your MCP client and exposes a focused set of Reflect tools for working with graphs, books, links, and notes.

How to install

Prerequisites: ensure you have Node.js version 20 or newer installed on your machine.

Install or use the MCP Connector through your MCP client as shown in the configuration examples. The server runs via a stdio command, typically using npx to fetch the latest package.

# If you prefer using npx to run the latest connector
npx -y reflect-mcp-connector@latest

Additional configuration and usage notes

Configure your MCP client with the Reflect access token and optional defaults. You can provide a default graph to avoid passing graph identifiers on every call.

OAuth helper (optional) lets you obtain an access token via a browser flow. It prints an access token you can paste into your MCP client configuration.

REFLECT_CLIENT_ID="..." REFLECT_CLIENT_SECRET="..." npx -y reflect-mcp-connector@latest auth login

Configuration

Server configuration (required): set your Reflect access token and optional defaults.

OAuth helper configuration (optional): provide client id/secret and redirect URI if you plan to use the interactive login flow.

Security

Never commit tokens or OAuth secrets. Prefer setting credentials in your MCP client configuration rather than relying on local files or working directories.

Tools

Tools exposed by the Reflect MCP Connector include the following endpoints for retrieving and creating Reflect content.

Troubleshooting

If you encounter connectivity issues, verify that you provided REFLECT_ACCESS_TOKEN correctly in your MCP client configuration and that the token has the necessary scopes. Use the helper commands to verify connectivity and retrieve your graph list.

Available tools

reflect_get_me

Fetches information about the currently authenticated Reflect user and account.

reflect_list_graphs

Lists all graphs available in your Reflect account.

reflect_list_books

Lists books stored in Reflect associated with your graphs.

reflect_list_links

Lists links connected to your graphs or notes in Reflect.

reflect_create_link

Creates a new link within a Reflect graph.

reflect_append_daily_note

Appends a daily note to the selected Reflect graph or workspace.

reflect_create_note

Creates a new note in Reflect within a specified graph.