StoryOS
MCP server connecting Claude or ChatGPT to a StoryOS workspace of records, tasks
- Pricing
- Open source
- Platforms
- Web, CLI, API
- Runs
- Locally or Remotely
- Version
- 0.1.2
- Listing updated
- today
Similar MCP servers
About StoryOS
StoryOS is an open-source MCP server for developer tools. It can run locally on your machine or as a hosted remote server.
The README describes this server as a thin, stateless layer over the same API the StoryOS web app uses, so an AI client reads and writes the same customers, jobs, tasks and invoices a team sees in the browser. Access is through a personal API token scoped to one workspace, and the server exposes read, write, schema-building and automation tools.
Writes made through a connected assistant appear in StoryOS as made by the AI under the connecting person's name, and actions the site marks as gated wait in an inbox for a human to approve. The README also notes that the server can be pointed at a self-hosted instance or the cloud app and offers a hosted Streamable HTTP endpoint for connectors that cannot run a local process.
It suits people who already keep business records in StoryOS and want Claude or ChatGPT to query, update and comment on them. Automation tools are limited to admin-scoped tokens.
Install
Run in a terminal
claude mcp add --transport http storyos https://mcp.storyos.dev/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.storyos.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"storyos": {
"url": "https://mcp.storyos.dev/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"storyos": {
"type": "http",
"url": "https://mcp.storyos.dev/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"storyos": {
"serverUrl": "https://mcp.storyos.dev/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"storyos": {
"type": "http",
"url": "https://mcp.storyos.dev/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
STORYOS_TOKENStoryOS personal API token (mn_pat_...), created under API tokens in StoryOS. Scoped to one workspace.RequiredSTORYOS_URLBase URL of the StoryOS API, for example https://app.storyos.dev for the cloud. When unset the server uses http://localhost:3001 (local development).STORYOS_MCP_PROFILESet to internal to also expose the internal tool profile. Leave unset for the default tools.WEB_URLBase URL of the StoryOS web app, used to build links in tool results. When unset the server uses http://localhost:3000.
Tools this server provides (41)
Taken from the project documentation; the running server may differ.
- get_started
- Orientation and workspace map, with optional reference sections.
- list_workspaces
- Workspaces the token can access.
- list_databases
- Databases in a workspace.
- describe_database
- A database's schema with exact api names, types and options.
- search
- Full-text record search.
- query_records
- Filter, sort and paginate records.
- get_record
- One record in full by uuid or public number.
- get_links
- Web-app URLs for databases, views and records.
- create_record
- Create a record with values and relations.
- update_record
- Merge-update a record.
- delete_record
- Trash a record, restorable for 30 days.
- link_records
- Link records through a relation field.
- unlink_records
- Remove specific links from a relation field.
- add_comment
- Post a comment on a record.
- attach_file
- Attach a file to a record from a URL or base64 content.
- list_attachments
- List a record's files.
- delete_attachment
- Remove a file from a record.
- run_button
- Press a button field to run its actions.
- list_spaces
- List spaces.
- create_space
- Create a space.
- create_database
- Create a database.
- update_database
- Rename or move a database.
- delete_database
- Delete a database.
- add_field
- Add a field to a database.
- update_field
- Update a field.
- delete_field
- Delete a field.
- change_field_type
- Convert a field's type.
- create_view
- Create a view.
- update_view
- Update a view.
- delete_view
- Delete a view.
- create_relation
- Link two databases with a relation.
- delete_relation
- Remove a relation between databases.
- reorder_fields
- Set field order.
- reorder_views
- Set view order.
- list_skills
- Skills visible to the caller.
- run_skill
- Resolve a skill's instructions and record the run.
- list_automations
- Rules on a database with triggers and last-run status.
- get_automation
- One rule's full editable definition.
- create_automation
- Create an automation rule.
- update_automation
- Update an automation rule.
- delete_automation
- Delete an automation rule.
What it does
- Record querying and editing
- Filter, sort, create, update, link and delete records in a StoryOS workspace by field name.
- Schema-aware writes
- A describe-database tool returns exact field names and types so assistants write against the real schema.
- Comments and file attachments
- Add comments to records and attach files from a URL or inline base64 content.
- Workspace building tools
- Create spaces, databases, fields, views and relations for admin-scoped tokens.
- Automation management
- List, create, update and delete automation rules on a database for admin tokens.
- Skills as resources and prompts
- Workspace skills are exposed as MCP resources and prompts as well as tools.
Good for
- Asking an assistant what tasks are overdue across client jobs
- Turning call notes into tasks linked to a specific job
- Drafting client status updates from open work on each record
- Building a new database and views from a plain-language description
- Attaching files or comments to customer records from a chat
Pricing
Open source, from $29 a month
Server is open to use with a StoryOS account; hosted plans Free, Pro $29/mo and Business $99/mo per workspace.
Prices change. Check storyos.dev before you buy.
StoryOS FAQ
How does the server authenticate?
Each user creates a personal API token in StoryOS (prefixed mn_pat_), scoped to one workspace, and sets it as STORYOS_TOKEN. The hosted endpoint takes the token as a Bearer header on each request.
Which transports are supported?
The package runs over stdio for local clients, and the README describes a stateless Streamable HTTP endpoint at /mcp for hosted use.
Which tools are only available to admins?
The README says the five automation tools are advertised only to admin-scoped tokens, so read- or write-scoped tokens cannot see or change rules.
What is the package license?
The README does not state a license for the MCP package itself. The StoryOS pricing page says the product is AGPL-3.0 and can be self-hosted.
Is StoryOS free?
Yes. StoryOS is open source, so you can use and self-host it for free.
How do I add StoryOS to Claude Code?
Run this command in your terminal: claude mcp add --transport http storyos https://mcp.storyos.dev/mcp
What are the best alternatives to StoryOS?
The closest alternatives to StoryOS are TestOrchestrator, AIOS Builder, Toolstile and Falcon Builder.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
