
Sequential Thinking MCP Server by arben-adm: Setup for Claude, Cursor and Other Apps
Gives Claude, Cursor and other assistants saved working notes for a hard task, so they can pick it up again after a restart.
MCP Sequential Thinking stores the notes your assistant writes for a task, such as evidence, risks, decisions and next actions. It keeps them in a SQLite file on your computer and reads them back when you resume. It records what the assistant writes. It does not think or judge for it.
It is a community project by Arben Ademi (arben-adm) and runs locally with no account or API key. The notes are saved as plain text, so do not put secrets in them. Older single-history tools remain but are marked deprecated.
Good for
- People who work through long decisions with an assistant and want the evidence and choices saved
- Developers who want a task to resume across Claude Code sessions
- Anyone who wants notes kept in a local file instead of a hosted service
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install MCP Sequential Thinking
Claude Code
- 1
Copy this prompt.
Add the MCP Sequential Thinking server to Claude Code. Run this command: claude mcp add sequential-thinking -- uvx mcp-sequential-thinking Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv (Python).
Built from the package data we hold. Not yet tested by us.
Tools
Starts a new notes session with a title
Creates a session to hold the notes for one task. Each write carries a request ID, so a repeated call does not create a duplicate.
Try: “Start a notes session called 'Choose a local database'.”
Write ·
create_sessionAdds a note to a session
Saves one note, tagged as a note, observation, evidence, assumption, option, risk, decision or next action. A note can replace an earlier one or start a named branch.
Try: “Add a decision to the session: use SQLite for storage.”
Write ·
add_stepFinds sessions by title or status
Lists saved sessions so you can find one again after a restart, for example when you lost its ID.
Try: “Find my session about the database choice.”
Read ·
list_sessionsReads back a session's notes
Shows the active notes with decisions first, or the full history with filters. Long sessions come back in pages.
Try: “Resume my 'Choose a local database' session and tell me what is still open.”
Read ·
read_sessionCloses a session with a stored outcome
Saves the final outcome and the IDs of the notes that support it. No more notes can be added afterwards.
Try: “Finalize the session with the outcome 'SQLite chosen' and link the decision note.”
Write ·
finalize_sessionDeletes a session's records from the database
Removes one session's rows from the local database. Exports and backups you made earlier stay, and the README says this is not secure erasure.
Try: “Delete the finished 'Old planning' session.”
Delete ·
delete_sessionWrites a session to a JSON file
Saves one session as an archive file inside the exports folder under the storage directory. Paths outside that folder are rejected.
Try: “Export the database-choice session to db-choice.json.”
Write ·
export_sessionLoads a session from an exported file
Reads an archive from the exports folder and adds it as a session. Without a session ID it replaces the old single shared history instead.
Try: “Import db-choice.json from the exports folder.”
Delete ·
import_sessionLegacy: records one numbered step of reasoning
Older tool that stores a numbered note with a stage such as Research or Analysis in one shared history. It is marked deprecated in favor of sessions.
Try: “Record step 1 of 5 in the Research stage.”
Write ·
process_thoughtLegacy: summarizes the shared history
Builds a deterministic summary of the legacy history from the recorded notes, with excerpts per stage and open branches. It does not create new reasoning.
Try: “Summarize the legacy notes recorded so far.”
Read ·
generate_summaryLegacy: erases the shared history
Deletes every record in the single legacy session and reports how many were removed. Exports and backups stay.
Try: “Clear the legacy thought history.”
Delete ·
clear_history
Read from the source code
Permissions
medium risk · 4 things to watch
Medium risk
The assistant can write, read and delete notes in a local database file, and it saves them as plain text. Deletes reach only this server's own notes, which is why the risk is medium rather than high.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Notes are saved as plain text on disk
Anything the assistant writes lands unencrypted in a SQLite file. Keep passwords and keys out of your notes, or run with the memory-only flag. github.com
It can delete saved notes
delete_session and clear_history remove only the notes this server stored in its own local database. They cannot touch other files or systems. The README says deletion is not secure erasure, and exports and backups are kept. Export first if you need a copy. github.com
Import replaces the old shared history
import_session without a session ID replaces the legacy history. Files must sit in the exports folder under the storage directory. github.com
Web modes are experimental and local by default
The server uses stdio by default. The sse and streamable-http options bind to 127.0.0.1 and need an extra flag to listen elsewhere, with no sign-in. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | No read-only switch is documented. The --ephemeral flag keeps notes in memory only and turns off file import and export. |
|---|---|
| Sign-in and keys | No account or API key. Notes are stored as plain text in a SQLite file under ~/.mcp_sequential_thinking, or the folder set in MCP_STORAGE_DIR. |
Questions
Is the Sequential Thinking MCP server by arben-adm official?
No. It is a community project by Arben Ademi (arben-adm), not the reference Sequential Thinking server from the MCP project, which is a different package with a different tool. This one saves notes rather than guiding reasoning. For the reference server see Sequential Thinking MCP.
Where are my notes stored?
In a SQLite file at ~/.mcp_sequential_thinking, or in the folder you set with MCP_STORAGE_DIR. The data is plain text and stays on your computer.
Does it need an API key?
No. It runs locally and has no account or key.
Can I run it without saving anything?
Yes. The memory-only flag keeps notes in memory until the server exits and turns off file import and export.
Does it make the assistant reason better?
No. The README says it records what the assistant writes and does not generate, judge or improve reasoning. Its value is that notes survive a restart.
What are the process_thought and clear_history tools?
They belong to an older single-history mode that the README marks deprecated. Use the session tools for new work.
How do I add it to Claude Code or Cursor?
Use the matching tab in the install box above, then restart the app.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
mcp-sequential-thinking- Registry
- PyPI
- Transport
- stdio
- Version
- 0.7.0
- License
- MIT
- Last commit
- Oct 23, 2026
- Open issues
- 1
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- README · github.com
- session_tools.py (v0.7.0) · github.com
- server.py · github.com