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

Go to your Reflect settings and create an OAuth application
Note your Client ID and Client Secret
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