{
  "markdown": "# Dabble Me\n### A private journal over email service.\n\nDabble Me helps people remember what's happened in their life. Use it as a light-weight journal on a daily, weekly, or even monthly basis...it's up to you! Dabble Me will email you on a time & days you choose - you simply reply to the email to post entries. The app is live at [https://dabble.me](https://dabble.me). This is a great replacement if you had ever used [OhLife](http://ohlife.com).\n\nThis app utilizes the following 3rd party services:\n\n* [CloudFlare](http://cloudflare.com) managed DNS + free SSL support (free for basic service)\n* [Mailgun](http://www.mailgun.com/rackspace) for Sending & Receiving Email (free for 50k emails per month)\n* [Amazon S3](http://aws.amazon.com) for Photo Uploads & Storage (free for 1 year)\n* [Google Analytics](http://google.com/analytics) for traffic stats (free for standard analytics)\n* [Turnstile](https://www.cloudflare.com/products/turnstile/) to prevent bot signups (free).\n* [Sentry](https://www.sentry.io/) to report errors (free)\n\nYou will need to setup Mailgun to receive incoming emails and point them to your app to parse.\n\nScheduled jobs (including hourly email sending) are run by [sidekiq-cron](https://github.com/sidekiq-cron/sidekiq-cron) inside the Sidekiq worker process. The schedule lives in `config/schedule.yml`. No external scheduler is required.\n\nYour local environment variables at ```config/local_env.yml``` (and on Railway) will need to be something like this (```rake db:seed``` will create the admin@dabble.ex account for you):\n\n```yaml\nMAIN_DOMAIN: yourdomain.com\nSECRET_KEY_BASE: 1234..1234\nDEVISE_SECRET_KEY: 1234..1234\nSMTP_DOMAIN: post.yourdomain.com\nMAILGUN_API_KEY=api-key\nTURNSTILE_SITE_KEY: 6Lc6BAAAAAAAAChqRbQZcn_yyyyyyyyyyyyyyyyy\nTURNSTILE_SECRET_KEY: 6Lc6BAAAAAAAAKN3DRm6VA_xxxxxxxxxxxxxxxxx\nGOOGLE_ANALYTICS_ID=UA-12345-67 ## ONLY FOR PRODUCTION\nSENTRY_DSN: https://dsn.sentry.io/1234\nOPENAI_ACCESS_TOKEN: sk-1234\nOPENAI_ORGANIZATION_ID: org-1234\nHUGGING_FACE_API_KEY: 1234\nSTRIPE_API_KEY: sk_test_1234\nSTRIPE_SIGNING_SECRET: whsec_1234\n```\n\n### Things you may want to rip out\n\nYou can opt to not use Turnstile: simply don't add an environment variables for `TURNSTILE_SITE_KEY`.\n\n### MCP (Model Context Protocol)\n\nPRO accounts can use Dabble Me as a **remote MCP server** so compatible clients (for example Claude) can search, list, analyze, and create journal entries after OAuth.\n\n**Requirements:** PRO subscription, plus a passkey or two-factor authentication on Account security (`/security`). Connected OAuth apps can be reviewed and revoked on the same page under **Connected apps** (shown only when something is connected).\n\n**Endpoint:** Streamable HTTP at `https://<MAIN_DOMAIN>/mcp` (see `MAIN_DOMAIN` in `config/local_env.yml`). The client should use OAuth: authorization metadata is published under `/.well-known/oauth-authorization-server` and `/.well-known/oauth-protected-resource` (see `Oauth::MetadataController`).\n\n**User-facing instructions:** Dabble Me MCP Server at `/mcp-server` on your host.\n\n**Deep links for assistants:** a single day opens at `https://<MAIN_DOMAIN>/entries/YYYY/M/D` with **unpadded** month and day (example: `https://dabble.me/entries/2026/4/21`). The web compose URL is `https://<MAIN_DOMAIN>/write`.\n\nFor generic remote-connector setup in Claude, see Anthropic’s [Get started with custom connectors using remote MCP](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp).\n\n**Registry metadata:** `server.json` describes the hosted Streamable HTTP endpoint for the official MCP Registry.\n\n**WebMCP / AI-client discovery:** public pages advertise `/.well-known/webmcp`, `/mcp/server-card`, and `/.well-known/ai-catalog.json`. In a signed-in browser tab, WebMCP also registers session journal tools (search, list, analyze, open a day, draft an entry without submitting). Search/analyze/draft need PRO. Remote MCP at `/mcp` still uses OAuth (PRO + passkey or 2FA). For the WebMCP Challenge, put a dedicated PRO demo account (email/password, no 2FA) on the submission form — do not use a real journal.\n\n**Automated smoke (curl + [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) CLI):** `./script/mcp_inspector_smoke.sh` uses `RAILS_ENV=test`, starts a short-lived Rails server, checks OAuth metadata and `/mcp`, then runs Inspector against all five tools (`tools/list` exercises `initialize` + connect). Aligns with Anthropic’s [Testing your connector](https://claude.com/docs/connectors/build/testing) guidance.\n\n### Tests\n\nThere is healthy coverage of the app, which you can run with:\n\n```\nrake\n```\n\n### Administration Portal\n\nThe Admin emails are accounts that have access to the Admin Dropdown in the navbar (lock icon) that give you details into the number of entries and users in the system.\n\n### Inspirations and Importers\n\nIf you want random bits of inspiration, you can load up different quotes in the Inspiration table to be shown above the New Posts page and at the bottom of emails. Import sources are tagged via Inspiration categories — seed OhLife / Ahhlife / Day One / Trailmix rows (see `db/seeds.rb`), or the Day One importer will create its category on first use.\n\n```ruby\nInspiration.create(category: 'OhLife', body: 'Imported from OhLife')\nInspiration.create(category: 'Day One', body: 'Imported from Day One')\n```\n\nPRO users can import from OhLife (text + photo ZIP), Day One (JSON ZIP export), Ahhlife (JSON paste), and Trailmix.life (JSON upload) at `/entries/import`.\n\n=====\n\n**Current features:**\n\n* Read past entries by month/year\n* Create new entries with simple formatting\n* Importers: OhLife, Day One, Ahhlife, Trailmix.life\n* Email: Reply-to-post new entries on days of the week you choose (with random past entries embedded)\n* Associate 1 image to a specific entry\n* Search with basic analytics around posting\n* Hashtag support for tagging your entries\n* Year in Review\n* MCP (PRO): OAuth-backed journal tools for external clients\n",
  "bytes": 6015,
  "sha": "00d68b25a53a4fe4eadbbb91109c626dabde602da6a3446db840a21c0fa05b7b",
  "repo_slug": "parterburn/dabble.me",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_parterburn_dabble_me_6d146d83/readme"
}