# FlowState MCP server

> Gives AI apps a shared, local project memory of todos, changes, decisions and lessons that syncs across chats and clients.

- Repository: https://github.com/dialectforge/FlowState
- Page: https://hostedmcp.org/servers/dialectforge/flowstate
- Transport: remote
- Stars: 22
- License: MIT
- Latest version: 1.0.1

## Install

### Claude Code

```sh
claude mcp add --transport http flowstate https://hosted.flowstatemcp.com/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "flowstate": {
      "url": "https://hosted.flowstatemcp.com/mcp"
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "flowstate": {
      "type": "http",
      "url": "https://hosted.flowstatemcp.com/mcp"
    }
  }
}
```

### Codex (`~/.codex/config.toml`)

```toml
[mcp_servers.flowstate]
url = "https://hosted.flowstatemcp.com/mcp"
```

### Gemini CLI (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "flowstate": {
      "httpUrl": "https://hosted.flowstatemcp.com/mcp"
    }
  }
}
```

## Tools (16)

- `start_here`
- `log_work`
- `search`
- `manage_todos`
- `manage_problems`
- `manage_review`
- `manage_handoffs`
- `manage_rules`
- `manage_links`
- `manage_history`
- `manage_projects`
- `manage_memory`
- `show_review_card`
- `show_conflict_card`
- `resolve_review_card`
- `resolve_conflict_card`

## FAQ

### Where does FlowState store my data?

Everything is stored in a single SQLite file on your own computer, so memory stays local unless you enable an optional off-site feature.

### Which AI apps can use FlowState?

Any MCP client works, including Claude, ChatGPT, Cursor and Grok, and several can use the same memory at once.

### Does FlowState make network calls?

It makes one call a day to GitHub to check for newer releases, which sends nothing about you or your projects and can be turned off.

### Is FlowState free?

Yes, the local version is free and open source under the MIT license, with an optional paid hosted version.

### Can two AI agents work on the same project without duplicating work?

An agent claims a todo before starting it, and other agents see the claim and skip that item until the claim expires or is released.