flowstatemcp
Local-first shared project memory for AI apps. One SQLite file on your computer holds the
todos, changes, decisions, problems, and lessons your AI apps share. The import package is
flowstate. The PyPI name is flowstatemcp, because flowstate is a different project.
- Site: https://flowstatemcp.com
- Hosted (no install): https://flowstatemcp.com/hosted
- Source: https://github.com/dialectforge/FlowState
Install
You need Python 3.11+ and uv for the one-command form.
uvx flowstatemcp
That starts the stdio MCP server. These do the same thing:
pipx run flowstatemcp
pip install flowstatemcp
flowstatemcp
flowstate
pip install flowstate does not install this project.
The git clone is the fallback when you want setup_flowstate.py to write app configs, schedule
backups, and install the FlowState skill. See the repository
README.
Run
flowstatemcp # stdio (what desktop apps start)
flowstate # the same server
python -m flowstate --transport http --host 127.0.0.1 --port 8766
flowstate --help
The database is FLOWSTATE_DB if set, otherwise the per-OS default in the repository AGENTS.md.
A plain pip install flowstatemcp (or of a built wheel) includes the base schema
(flowstate/schema.sql), the migrations, and release_signers. flowstate update only works
in a git clone set up by setup_flowstate.py. Like every FlowState 2.4.0 or later, it checks
GitHub once a day for a newer release (nothing about you or your projects is sent);
flowstate update check off or FLOWSTATE_UPDATE_CHECK=0 turns that off.
Search by meaning is optional; see "Honest limits" in the repository README.
Metadata
Release files for flowstatemcp 2.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| flowstatemcp-2.5.0.tar.gz | 540.9 kB | With provenance | Details for flowstatemcp-2.5.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| flowstatemcp-2.5.0-py3-none-any.whl | Python 3 | none | any | Details for flowstatemcp-2.5.0-py3-none-any.whl |
Total release size: 1.2 MB
Release files / flowstatemcp-2.5.0.tar.gz
| Download URL | flowstatemcp-2.5.0.tar.gz |
|---|---|
| Size | 540.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
72de17311fa2d633fa774e0626e6a698a13b5e81f180d1d38a1173a9029cbeb4
|
|
BLAKE2b-256 checksum How to use checksums |
d26175880043752b2c35f1cd8a5f906fb0b4f86291cc1b914e8e3992c87a5cd0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.
Transparency logRelease files / flowstatemcp-2.5.0-py3-none-any.whl
| Download URL | flowstatemcp-2.5.0-py3-none-any.whl |
|---|---|
| Size | 619.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ab067a7f6546f82d16e15c3bdff8d0407e30ab442e3387ae14318e2e12d311a9
|
|
BLAKE2b-256 checksum How to use checksums |
3d2fd1c3aa242750cfa01c8af8931acc58f503e28bdf7a294b1fc0c9fbb3953f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.
Transparency logSecurity for flowstatemcp 2.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for flowstatemcp-2.5.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.