{"id":47619685,"url":"https://github.com/prysmakou/memlog","last_synced_at":"2026-04-01T21:57:08.848Z","repository":{"id":345962960,"uuid":"1187954968","full_name":"prysmakou/memlog","owner":"prysmakou","description":"Markdown notes for humans, MCP-native for AI agents.","archived":false,"fork":false,"pushed_at":"2026-03-21T20:46:55.000Z","size":472,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-22T05:06:06.203Z","etag":null,"topics":["full-text-search","markdown","mcp-server","model-context-protocol","note-taking","notes","rust","self-hosted","vibe-coding"],"latest_commit_sha":null,"homepage":"https://github.com/prysmakou/memlog/wiki","language":"Rust","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prysmakou.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-21T12:22:34.000Z","updated_at":"2026-03-21T20:46:56.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/prysmakou/memlog","commit_stats":null,"previous_names":["prysmakou/memlog"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/prysmakou/memlog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prysmakou%2Fmemlog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prysmakou%2Fmemlog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prysmakou%2Fmemlog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prysmakou%2Fmemlog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prysmakou","download_url":"https://codeload.github.com/prysmakou/memlog/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prysmakou%2Fmemlog/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31292631,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["full-text-search","markdown","mcp-server","model-context-protocol","note-taking","notes","rust","self-hosted","vibe-coding"],"created_at":"2026-04-01T21:57:07.989Z","updated_at":"2026-04-01T21:57:08.831Z","avatar_url":"https://github.com/prysmakou.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build](https://github.com/prysmakou/memlog/actions/workflows/build.yml/badge.svg)](https://github.com/prysmakou/memlog/actions/workflows/build.yml)\n[![Docker](https://ghcr-badge.egpl.dev/prysmakou/memlog/latest_tag?trim=major\u0026label=docker)](https://github.com/prysmakou/memlog/pkgs/container/memlog)\n[![Python](https://img.shields.io/badge/python-3.13%2B-blue)](https://www.python.org/)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n\nMarkdown notes for humans, MCP-native for AI agents.\n\nA self-hosted, database-less note-taking app. Notes are plain `.md` files on disk. The backend is written in Python (FastAPI + Whoosh), the frontend is Vue 3. The Docker image ships both a web UI and an MCP server for AI agents.\n\n\u003e Inspired by [flatnotes](https://github.com/dullage/flatnotes) by dullage.\n\n## Quick start\n\n```yaml\nservices:\n  memlog:\n    image: ghcr.io/prysmakou/memlog:latest\n    ports:\n      - \"8080:8080\" # web UI + API\n      - \"8090:8090\" # MCP server\n    volumes:\n      - ./notes:/data\n    environment:\n      MEMLOG_PATH: /data\n      MEMLOG_AUTH_TYPE: password\n      MEMLOG_USERNAME: admin\n      MEMLOG_PASSWORD: changeme\n      MEMLOG_SECRET_KEY: change-this-to-a-random-secret\n    restart: unless-stopped\n```\n\n```bash\ndocker compose up -d\n```\n\nOpen `http://localhost:8080`. Full docs at **[prysmakou.github.io/memlog](https://prysmakou.github.io/memlog/)**.\n\n## MCP Server\n\nMemlog ships a built-in MCP server ([Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)) on port `8090`.\n\n**Tools:** `list_notes`, `search_notes`, `get_note`, `create_note`, `append_to_note`, `update_note`, `delete_note`, `list_tags`\n\n```bash\nclaude mcp add --transport http --scope user memlog http://\u003chost\u003e:8090/mcp\n```\n\nSee the [MCP Server docs](https://prysmakou.github.io/memlog/mcp-server/) for auth token setup.\n\n## Development\n\nInstall [just](https://just.systems/man/en/packages.html), [uv](https://docs.astral.sh/uv/), and Node 22, then:\n\n```bash\njust install      # npm deps + git hooks\njust backend      # Python backend on :8000 (auth disabled, notes in ./tmp-notes)\njust frontend     # Vue dev server on :8080 (proxies API to :8000)\njust test         # pytest (50 tests)\njust test-mcp     # MCP server tests (13 tests)\njust build        # build Docker image (tag=local)\njust run          # run Docker image locally (auth disabled)\n```\n\n## Architecture\n\n```\nclient/       Vue 3 SPA (Vite)\nserver/       Python backend (FastAPI, Whoosh)\nmcp-server/   Python MCP server (FastMCP, Streamable HTTP)\n```\n\nNotes are stored as plain `.md` files in `MEMLOG_PATH`. Full-text search uses a [Whoosh](https://whoosh.readthedocs.io/) index stored in `MEMLOG_PATH/.memlog/`. There is no database.\n\n**Optional:** semantic (vector) search via [Qdrant](https://qdrant.tech/) + [Voyage AI](https://www.voyageai.com/) or [Ollama](https://ollama.com/). Set `MEMLOG_QDRANT_URL` to enable; see the [Search docs](https://prysmakou.github.io/memlog/search/#semantic-search) for setup.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprysmakou%2Fmemlog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprysmakou%2Fmemlog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprysmakou%2Fmemlog/lists"}