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:

Then fill in your credentials:

Generate a secure encryption key:

Running Locally

1. Install Dependencies

2. Start the Development Server

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:

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:

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

License

MIT