Your notes, for your AI agent.
Let the agent you already use read, search and write your Syphony notes: pages, databases, LaTeX papers, meeting transcripts. One step, on your own computer. You choose what it may do, and you see it work.
Claude Code
Have Syphony open, with the project you want Claude to work in.
-
Add Syphony's plugin.
In Claude Code, type these two lines. The plugin connects Claude to Syphony and teaches it how your pages work.
/plugin marketplace add SynomyCloud/syphony-agent /plugin install syphony@syphony
Or only the connection, from a terminal:
claude mcp add --transport http -s user syphony http://127.0.0.1:51740/mcp -
Allow it, once.
Type /mcp, choose syphony and Authenticate. Your browser opens a page from Syphony itself: choose how far Claude reaches and what it may do, and press Allow.
-
Ask.
“Summarise last week's meetings into a page called Week 44.” “Add a Due column to my Tasks database and fill it in.” “Write the introduction of my paper in LaTeX.”
Codex
Have Syphony open, with the project you want Codex to work in. In a terminal:
-
Add Syphony.
codex mcp add syphony --url http://127.0.0.1:51740/mcp
-
Allow it, once.
codex mcp login syphony
Your browser opens a page from Syphony itself: choose how far Codex reaches and what it may do, and press Allow.
-
Teach it how Syphony works (optional).
Syphony's skill tells Codex how your pages, databases and LaTeX pages work, so it changes them well:
codex plugin marketplace add SynomyCloud/syphony-agent
Claude Desktop
Claude Desktop's own connectors reach servers on the internet, and Syphony is on your computer, so it goes through a small bridge. You need Node.js.
-
Open Claude's settings file.
In Claude Desktop: Settings → Developer → Edit Config.
-
Add Syphony to it.
Put this in the file (beside any servers already in
mcpServers), save, and restart Claude Desktop.{ "mcpServers": { "syphony": { "command": "npx", "args": ["-y", "mcp-remote", "http://127.0.0.1:51740/mcp", "--allow-http"] } } } -
Allow it, once.
Your browser opens a page from Syphony itself: choose how far Claude reaches and what it may do, and press Allow.
Cursor
Have Syphony open, with the project you want Cursor to work in.
-
Add Syphony.
Add to CursorOr put it in
~/.cursor/mcp.jsonyourself:{ "mcpServers": { "syphony": { "url": "http://127.0.0.1:51740/mcp" } } } -
Allow it, once.
In Settings → MCP, press Connect beside syphony. Your browser opens a page from Syphony itself: choose what Cursor may do, and press Allow.
VS Code
For GitHub Copilot's agent mode. Have Syphony open, with the project you want it to work in.
-
Add Syphony.
Add to VS CodeOr from a terminal:
code --add-mcp '{"name":"syphony","type":"http","url":"http://127.0.0.1:51740/mcp"}' -
Allow it, once.
When VS Code asks to sign in to syphony, say yes. Your browser opens a page from Syphony itself: choose what the agent may do, and press Allow.
Any other agent
Syphony speaks the Model Context Protocol, so any agent that can add an MCP server can use it. Give it this address:
http://127.0.0.1:51740/mcp
-
If your agent can sign in to a server
OpenCode, Zed, Cline and Devin can. Add the address with no key, sign in when asked, and press Allow on the page Syphony opens in your browser.
-
If it needs a key
In Syphony, open Settings → API, press New key, choose what it may do, and copy the key. Give it to your agent as a header:
Authorization: Bearer synomy_…
Antigravity, for example, in
~/.gemini/config/mcp_config.json:{ "mcpServers": { "syphony": { "serverUrl": "http://127.0.0.1:51740/mcp", "headers": { "Authorization": "Bearer synomy_…" } } } } -
Teach it how Syphony works
Agents that read skills (Codex, Cursor, VS Code, OpenCode, Antigravity) find Syphony's in
~/.agents/skills. One line puts it there, and adds Syphony to Claude Code and Codex if you have them:curl -fsSL https://raw.githubusercontent.com/SynomyCloud/syphony-agent/main/install.sh | sh
What your agent can do
- Find and read any page it may reach, search your notes, and follow what changes.
- Write: make pages, change words in them without disturbing the rest, add pictures, move pages around.
- Fill databases: add rows, set their values, add and rename columns.
- Write LaTeX and HTML pages: make one from a template and write its files. Syphony compiles it while you have it open.
- Use your meetings: read transcripts, and write summaries and action items next to them.
- Undo its own mistakes: what it deletes goes to the trash, and every page keeps its history.
You see it work
While your agent works, it has a pointer in your window, like a friend editing the same page. It goes to what the agent reads, presses where it writes, and the words it changed light up for a moment. The pointer carries the agent's name and a sparkle, so you always know it is an AI and not a person.
You stay in charge
Your notes never leave your computer for this: the agent talks to Syphony on your own machine, at 127.0.0.1, and only while Syphony runs. When it asks to connect, you choose how far it reaches — the whole project, one page and what is inside it, or only meeting transcripts — and whether it may only read, also change, or also delete. Every agent you let in is listed in Settings → API under its own name, and removing it there stops it at once.
If something does not work
- The agent cannot reach Syphony. Syphony has to be running. If you chose another port in Settings → API, use that number instead of 51740.
- It says the project is not open. An agent is let into the project that was open when you pressed Allow. Open that project in Syphony.
- It may not do something. Remove it in Settings → API and connect it again with more access.
- For your own scripts, the full guide to Syphony's API is served by the app itself at 127.0.0.1:51740 while it runs.