# Moe Memos Android: Kotlin Client for Self-Hosted and Local Note-Taking

> Moe Memos is a third-party Android app by mudkipme for the usememos/memos server, built with Kotlin and Jetpack Compose, that works either connected to a self-hosted memos instance or entirely locally on device without requiring a server.

**mudkipme/MoeMemosAndroid** — An app to help you capture thoughts and ideas

- Repository: https://github.com/mudkipme/MoeMemosAndroid
- Website: https://memos.moe
- Stars: 1,197 · Forks: 139
- Language: Kotlin
- License: GPL-3.0
- Published: 2026-09-10 · Updated: 2026-09-10 · Language: en
- Canonical page: https://hysenlabs.com/projects/mudkipme-moememosandroid

## A native Android client for the usememos ecosystem

The usememos/memos project is a self-hosted note-taking service with a web interface. Moe Memos is a third-party Android client that connects to a memos server and provides a native experience that the memos project does not officially ship for Android. The README explicitly states that Moe Memos and usememos/memos are not affiliated with each other.

The app is maintained by mudkipme and built with Kotlin and Jetpack Compose. The design philosophy, as stated in the README, is to keep the app minimal and optimized for the best native experience. The primary use case is for developers or technical users who already operate a self-hosted memos server and want a mobile client with full Android integration: home screen widgets, share sheet support for text, images, and webpages, dynamic Material You themes, and offline-first sync. A secondary mode runs the app locally without any server at all.

## Two operating modes: server-connected and fully local

The most distinctive feature for potential adopters is the local mode. The README describes it as using Moe Memos locally on your device with export, requiring no server. This means a user who wants a quick private note-taking app without the overhead of setting up and maintaining a server can install Moe Memos and use it immediately. Local data can be exported.

In server-connected mode, the app syncs with a self-hosted memos server and provides offline-first behavior: notes created offline are queued and synced automatically when a network connection is restored. The app stores data locally first and treats the server as a secondary destination, not a required one for immediate operation. This design makes the app functional even on intermittent connections, which is common for mobile use cases.

## Installing from F-Droid, Google Play, or APK

Moe Memos is available through three channels. F-Droid is the open-source Android app repository, and the package ID on F-Droid is me.mudkip.moememos. The same app is on Google Play under the same package ID. For users who prefer not to use either store, the Releases section of the GitHub repository provides downloadable APK files.

Version 2.0.5 was released on 2026-09-16, version 2.0.4 on 2026-07-16, and 2.0.3 on 2026-04-20. The repository uses fastlane for release management, which is a standard practice for automating Android app signing and distribution. The .justfile at the root suggests a justfile-based task runner for common development commands. Building from source requires Android development tools, a Gradle installation, and the SDK, though the README does not detail the build steps.

## Rich memo content and Android system integration

Moe Memos supports Markdown editing and rendering, image attachments, non-image attachments, and to-do items within memos. Organization features include tags, pinning, and full-text search. The app also shows a progress graph of memo activity over time, giving a visual summary of note-taking frequency.

Android system integration goes beyond basic note-taking. The home screen widget lets users create a new memo directly from the launcher without opening the app. The share sheet integration accepts text, images, and webpages shared from other apps. This is the practical benefit of a native app over a web view: the usememos/memos web interface cannot receive Android share intents or place native widgets on the home screen. The README lists no data collection and describes the app as providing full privacy protection.

## The Memos API version constraint

Moe Memos supports specific versions of the memos server API. The README states that the current version supports Memos 0.21.0 and Memos 0.27.0 through 0.31.0. The usememos/memos project has changed its API across major versions, and Moe Memos has not yet updated to support versions above 0.31.0.

For users on memos 0.32.0 or later, the README recommends a specific workaround: use Mortis (github.com/mudkipme/mortis), a separate tool by the same developer that converts the newer memos API to the Memos 0.21.0 API format. After setting up Mortis, log in to Moe Memos again. This is an active constraint. Users who upgraded their memos server beyond 0.31.0 before upgrading the app will find that the app cannot connect until they either use Mortis or downgrade the server. The README acknowledges this directly: 'Memos update may introduce breaking API changes.'

## What the app does not include

Moe Memos is a capture and organization tool for text, images, and links. It does not include AI-assisted writing, note summarization, or any kind of content analysis. The design is described in the README as minimal, which means features that go beyond the core capture-and-retrieve use case are generally out of scope.

The app does not include collaboration features; memos are personal and the server access model follows the single-user memos server model. There is no desktop app in this repository; the codebase is Android-only (Kotlin with Jetpack Compose). iOS users who want a similar experience would need to use the memos web interface directly in a browser, or find a separate iOS client. The README also does not document the full export format for local-mode data, so teams who need guaranteed data portability should test the export before committing to local mode.

## Comparison with mobile browser access to the memos web interface

The usememos/memos project includes a responsive web interface that is usable on mobile browsers. Users who access it through a browser get the full feature set of the server-side interface, including any new features added after the last Moe Memos release. The tradeoff is that a browser-based interface cannot receive Android share intents, cannot place home screen widgets, does not support offline-first creation without service worker configuration, and does not use Material You dynamic theming.

Moe Memos gives up version-compatibility currency for native integration: it supports only specific server API versions, but in return it offers a deeper Android experience. For users who primarily want to create memos from other apps using the share sheet, or who want a widget on their home screen, the native app is the practical choice. For users who frequently need features the app has not yet implemented or who run newer server versions, the web interface is less restrictive.

## GPL-3.0 license and maintenance status

The last push to MoeMemosAndroid was on 2026-09-27. The project is not archived. The license is GPL-3.0, which requires that any modified version distributed to others must also be released under GPL-3.0 and include the source code. Organizations planning to fork and distribute a customized version to employees or customers need to comply with these terms. Internal use without distribution does not trigger the share-alike requirement.

The regular release cadence (three releases in 2026 as of September) and the recent last push indicate active maintenance. The repository includes a .github/ directory for CI configuration and fastlane for automated release management. Contributions are welcome according to the README. The app is described as a third-party project, not an official usememos client, so its continued compatibility with future memos server versions depends on the developer tracking upstream API changes.

## Conclusion

Moe Memos is a practical choice for Android users who run a self-hosted usememos/memos server on versions 0.21.0 or 0.27.0 through 0.31.0, and who want a native Material You experience instead of the mobile web view. Users on memos versions above 0.31.0 must first set up the Mortis adapter or downgrade the server. The GPL-3.0 license means any modifications distributed to others must also be released under GPL-3.0, which matters for organizations considering a forked internal version. For users who only want local note-taking without a server, the app's local mode covers that without additional infrastructure.

## FAQ

### Can Moe Memos work without a self-hosted memos server?

The README states that Moe Memos can be used locally on your device without a server, with an export option for the local data. A server connection is optional, not required.

### Which versions of usememos/memos does Moe Memos support?

The README states that Moe Memos supports Memos 0.21.0 and Memos 0.27.0 through 0.31.0. For server versions above 0.31.0, the README recommends using Mortis to convert the newer API to the Memos 0.21.0 format.

### Is Moe Memos an official app from the usememos project?

The README explicitly states that Moe Memos is a third-party client for usememos/memos and that the two projects are not affiliated with each other.

## Sources

- [License: GPL-3.0](https://github.com/mudkipme/MoeMemosAndroid/blob/main/LICENSE)
- [mudkipme/MoeMemosAndroid on GitHub](https://github.com/mudkipme/MoeMemosAndroid)
- [Project website](https://memos.moe)
- [README](https://github.com/mudkipme/MoeMemosAndroid/blob/main/README.md)
- [Releases](https://github.com/mudkipme/MoeMemosAndroid/releases)

---

Hysen Labs editorial analysis, written from the project's own repository and release notes. Cite the canonical page: https://hysenlabs.com/projects/mudkipme-moememosandroid
