Skip to content
MCP server

StoryOS

MCP server connecting Claude or ChatGPT to a StoryOS workspace of records, tasks

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.storyos.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "storyos": {
      "url": "https://mcp.storyos.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.Required
  • STORYOS_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.

How AIPoweredBot checks servers