Reflect MCP Connector
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Reflect MCP Connector
Connect your Reflect account to any MCP-compatible client (Claude Desktop, Claude Code, Codex, etc.).
This repo provides an MCP server that runs over stdio and exposes a small set of high-signal tools for Reflect (graphs/books/links + creating/appending notes).
Requirements
Node.js
>= 20
Quickstart (end users)
1) Get a Reflect access token
Generate an access token in Reflect’s developer settings and copy it:
You’ll set it as REFLECT_ACCESS_TOKEN in your MCP client config.
2) Add the server to your MCP client
Most MCP clients need:
a command (recommended:
npx)args (recommended:
-y reflect-mcp-connector@latest)environment variables (
REFLECT_ACCESS_TOKEN)
If you publish this under a different npm package name (e.g. a scope), replace reflect-mcp-connector@latest accordingly.
Claude Desktop
In claude_desktop_config.json, add:
{
"mcpServers": {
"reflect": {
"command": "npx",
"args": ["-y", "reflect-mcp-connector@latest"],
"env": {
"REFLECT_ACCESS_TOKEN": "REDACTED"
}
}
}
}You can also copy examples/claude_desktop_config.json and edit the paths/env.
Optional: set REFLECT_DEFAULT_GRAPH_ID to a specific graph id so you don’t need to pass graphId to every tool call.
If you prefer not to use npx, you can install globally and set command to reflect-mcp-connector:
npm install -g reflect-mcp-connectorClaude Code
Add the server via the Claude Code CLI:
claude mcp add -e REFLECT_ACCESS_TOKEN="REDACTED" reflect -- npx -y reflect-mcp-connector@latestOptional: add -e REFLECT_DEFAULT_GRAPH_ID="..." to set a default graph.
Codex
Add the server via the Codex CLI:
codex mcp add reflect --env REFLECT_ACCESS_TOKEN="REDACTED" -- npx -y reflect-mcp-connector@latestOptional: add --env REFLECT_DEFAULT_GRAPH_ID="..." to set a default graph.
3) Try it
Run the tool reflect_get_me or reflect_list_graphs to confirm connectivity and grab your graph id.
Tools
reflect_get_mereflect_list_graphsreflect_list_booksreflect_list_linksreflect_create_linkreflect_append_daily_notereflect_create_note
Configuration
Server:
REFLECT_ACCESS_TOKEN(required)REFLECT_DEFAULT_GRAPH_ID(optional; if unset the server uses the first graph id on your account)REFLECT_API_BASE_URL(optional; defaults tohttps://reflect.app/api)
OAuth helper:
REFLECT_CLIENT_ID(required)REFLECT_CLIENT_SECRET(optional)REFLECT_OAUTH_REDIRECT_URI(optional; defaults tohttp://127.0.0.1:8787/callback)
OAuth helper (optional)
If you don’t have an access token yet, run the OAuth PKCE helper:
REFLECT_CLIENT_ID="..." REFLECT_CLIENT_SECRET="..." npx -y reflect-mcp-connector@latest auth loginThis prints an authorization URL, starts a localhost callback server, and prints a REFLECT_ACCESS_TOKEN you can paste into your MCP client.
Development (from source)
If you want to run from this GitHub repo (development/contributing), you can use a .env file (this repo ignores .env*):
npm install
npm run build
cp .env.example .env
npm run devPublishing a new version
This repo publishes to npm via GitHub Actions on version tags (v*). Prereq: set the NPM_TOKEN GitHub Actions secret with an npm token that can publish reflect-mcp-connector.
# bump version + create git tag (vX.Y.Z)
npm version patch # or minor / major
# push commit + tag to trigger release workflow
git push --follow-tagsSecurity
Never commit tokens or OAuth secrets.
Prefer setting env vars in your MCP client config (avoid relying on working directories /
.envloading).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Official MCP bridge to Exogram—the Personal AI Agent for your work, people, and life.
One memory, every AI. A shared, user-owned markdown memory your AI clients read and write over MCP.
Agent-native notes, tasks, dev-docs, vaults, sync & handoffs. MCP + OpenAPI dual surface.