Reflect MCP Server

# Reflect MCP Server A remote [MCP server](https://modelcontextprotocol.io/introduction) for [Reflect](https://reflect.app) 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: ```bash 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: ```bash openssl rand -hex 32 ``` ## Running Locally ### 1. Install Dependencies ```bash npm install ``` ### 2. Start the Development Server ```bash 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: ```json { "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](https://modelcontextprotocol.io/docs/tools/inspector): ```bash npx @modelcontextprotocol/inspector@latest ``` Enter your server URL (`http://localhost:8787/sse` for local or your deployed URL) and connect. ## License MIT