Skip to main content

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.

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)

Source distribution for flowstatemcp 2.5.0
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)

Table of built distributions (wheels) for flowstatemcp 2.5.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

2.5.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page