Reflect MCP Server

A remote MCP server for Reflect that enables AI assistants like Claude to interact with your Reflect notes through OAuth authentication.

Available Tools

• get_reflect_graphs: Get a list of all Reflect graphs accessible with your account

• append_to_reflect_daily_notes: Append content to your daily notes in a specific Reflect graph

  • graph_id: The graph identifier

  • content: Text/markdown to append

  • date: The date in ISO 8601 format (YYYY-MM-DD) — use the user's local date to avoid timezone issues

Local Setup

1. Create a Reflect OAuth App

1. Go to your Reflect settings and create an OAuth application

2. Note your Client ID and Client Secret

3. Set your redirect URL based on your deployment:

   • Remote: https://your-worker.your-subdomain.workers.dev/oauth/callback

   • Local: http://localhost:3000/oauth/callback

2. Configure Environment Variables

Create a .dev.vars file for local development:

cp .dev.vars.example .dev.vars

Then fill in your credentials:

REFLECT_CLIENT_ID=your_reflect_client_id
REFLECT_CLIENT_SECRET=your_reflect_client_secret
COOKIE_ENCRYPTION_KEY=your_random_string

Generate a secure encryption key:

openssl rand -hex 32

Running Locally

1. Install Dependencies

npm install

2. Start the Development Server

npm run dev

The server will start at http://localhost:8787.

3. Configure Claude Desktop for Local Use

Open Claude Desktop and navigate to Settings → Developer → Edit Config.

Update your configuration to point to the local server:

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

Restart Claude Desktop. A browser window will open for Reflect OAuth authentication. After you grant access, the tools will be available.

Note: Make sure your Reflect OAuth app has http://localhost:8787/oauth/callback as an allowed redirect URL.

Testing with MCP Inspector

You can test the server using the MCP Inspector:

npx @modelcontextprotocol/inspector@latest

Enter your server URL (http://localhost:8787/sse for local or your deployed URL) and connect.

License

MIT